Compartilhar via

Grupo de Produtos

  • Artigo

O objeto de grupo de produtos base, que contém os métodos utilizados para gerir um grupo de produtos.

Utilização de exemplo:

    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

    var productGroups = shoppingCampaign.productGroups().get();

    while (productGroups.hasNext()) {
        var group = productGroups.next();
    }

Métodos

Nome do Método Tipo de Devolução Descrição
asBrand ProductBrand Converte o grupo de produtos num grupo de produtos de marca.
asCategory ProductCategory Converte o grupo de produtos num grupo de produtos de categoria.
asChannel ProductChannel Converte o grupo de produtos num grupo de produtos de canal.
asChannelExclusivity ProductChannelExclusivity Converte o grupo de produtos num grupo de produtos de exclusividade de canal.
asCondition ProductCondition Converte o grupo de produtos num grupo de produtos de condição.
asCustomLabel ProductCustomLabel Converte o grupo de produtos num grupo de produtos de etiquetas personalizadas.
asItemId ProductItemId Converte o grupo de produtos num grupo de produtos de ID de item.
asProductType Tipo de Produto Converte o grupo de produtos num grupo de produtos de tipo de produto.
subordinados ProductGroupSelector Obtém um seletor utilizado para filtrar a lista de grupos de produtos subordinados deste grupo de produtos.
getAdGroup AdGroup Obtém o grupo de anúncios ao qual este grupo de produtos pertence.
getCampaign Campanha Obtém a campanha à qual este grupo de produtos pertence.
getDimension cadeia Obtém a dimensão deste grupo de produtos.
getEntityType cadeia Obtém o tipo desta entidade.
getId cadeia Obtém o ID que identifica exclusivamente este grupo de produtos.
getMaxCpc duplo Obtém o valor máximo de oferta de custo por clique para este grupo de produtos.
getStats Estatísticas Obtém os dados de desempenho deste grupo de produtos.
getValue Cadeia Obtém o valor deste grupo de produtos.
isExcluded Booleano Obtém um valor Booleano que determina se este grupo de produtos está excluído.
isOtherCase Booleano Obtém um valor Booleano que determina se este grupo de produtos representa todos os outros casos não representados pelo respetivo grupo de produtos colaterais.
principal Grupo de Produtos Obtém o grupo de produtos principal deste grupo de produtos.
setMaxCpc(double cpc) vazio Define o valor máximo de oferta de custo por clique a utilizar para este grupo de produtos.

asBrand

Converte este grupo de produtos num grupo de produtos de marca.

Nota

Não é necessário converter o grupo de produtos num grupo de produtos da Marca para aceder ao valor da marca. Pode aceder ao valor da marca ao chamar o método getValue .

Devoluções

Tipo Descrição
ProductBrand Contém os métodos utilizados para aceder às propriedades do grupo de produtos.

asCategory

Converte este grupo de produtos num grupo de produtos de categoria.

Nota

Não é necessário converter o grupo de produtos num grupo de produtos Categoria para aceder ao valor da categoria. Pode aceder ao valor da categoria ao chamar o método getValue .

Devoluções

Tipo Descrição
ProductCategory Contém os métodos utilizados para aceder às propriedades do grupo de produtos.

asChannel

Converte este grupo de produtos num grupo de produtos do Channel.

Nota

Não é necessário converter o grupo de produtos num grupo de produtos do Channel para aceder ao valor do canal. Pode aceder ao valor do canal ao chamar o método getValue .

Devoluções

Tipo Descrição
ProductChannel Contém os métodos utilizados para aceder às propriedades do grupo de produtos.

asChannelExclusivity

Converte este grupo de produtos num grupo de produtos Exclusividade de Canal.

Nota

Não é necessário converter o grupo de produtos num grupo de produtos Exclusividade de Canal para aceder ao valor do canal. Pode aceder ao valor do canal ao chamar o método getValue .

Devoluções

Tipo Descrição
ProductChannelExclusivity Contém os métodos utilizados para aceder às propriedades do grupo de produtos.

asCondition

Converte este grupo de produtos num grupo de produtos de condição.

Nota

Não é necessário converter o grupo de produtos num grupo de produtos Condição para aceder ao valor da condição. Pode aceder ao valor da condição ao chamar o método getValue .

Devoluções

Tipo Descrição
ProductCondition Contém os métodos utilizados para aceder às propriedades do grupo de produtos.

asCustomLabel

Converte este grupo de produtos num grupo de produtos de etiquetas personalizadas.

Nota

Não é necessário converter o grupo de produtos num grupo de produtos CustomLabel para aceder ao valor da etiqueta. Pode aceder ao valor da etiqueta ao chamar o método getValue . Só precisa de converter o grupo de produtos em CustomLabel se precisar de saber para que tipo de etiqueta se destina o valor. Por exemplo, etiqueta personalizada 0 a 4.

Devoluções

Tipo Descrição
ProductCustomLabel Contém os métodos utilizados para aceder às propriedades do grupo de produtos.

asItemId

Converte este grupo de produtos num grupo de produtos de ID de item.

Nota

Não é necessário converter o grupo de produtos num grupo de produtos ItemId para aceder ao valor do ID. Pode aceder ao valor do ID ao chamar o método getValue .

Devoluções

Tipo Descrição
ProductItemId Contém os métodos utilizados para aceder às propriedades do grupo de produtos.

asProductType

Converte este grupo de produtos num grupo de produtos de tipo de produto.

Nota

Não é necessário converter o grupo de produtos num grupo de produtos ProductType para aceder ao valor do tipo. Pode aceder ao valor do tipo ao chamar o método getValue . Só precisa de converter o grupo de produtos em ProductType se precisar de saber para que tipo serve o valor. Por exemplo, PRODUCT_TYPE_L1, etc.

Devoluções

Tipo Descrição
Tipo de Produto Contém os métodos utilizados para aceder às propriedades do grupo de produtos.

subordinados

Obtém um seletor utilizado para filtrar a lista de grupos de produtos subordinados deste grupo de produtos subordinados

Devoluções

Tipo Descrição
ProductGroupSelector Um seletor utilizado para filtrar a lista de subordinados neste grupo de produtos.

getAdGroup

Obtém o grupo de anúncios ao qual este grupo de produtos pertence.

Devoluções

Tipo Descrição
AdGroup O grupo de anúncios a que este grupo de produtos pertence.

getCampaign

Obtém a campanha à qual este grupo de produtos pertence.

Devoluções

Tipo Descrição
Campanha A campanha à qual este grupo de produtos pertence.

getDimension

Obtém a dimensão deste grupo de produtos.

Devoluções

Tipo Descrição
Cadeia A dimensão deste grupo de produtos. Os valores possíveis são:
  • RAIZ – a parte superior da árvore
  • MARCA
  • CATEGORIA
  • CONDIÇÃO
  • CUSTOM_LABEL
  • ITEM_ID
  • PRODUCT_TYPE

getEntityType

Obtém o tipo desta entidade.

Devoluções

Tipo Descrição
cadeia O tipo desta entidade, que é ProductGroup.

getId

Obtém o ID que identifica exclusivamente este grupo de produtos.

Devoluções

Tipo Descrição
cadeia O ID que identifica exclusivamente este grupo de produtos.

getMaxCpc

Obtém o valor máximo de oferta de custo por clique deste grupo de produtos.

Devoluções

Tipo Descrição
duplo O montante da oferta. Devolve nulo se não estiver definido ou se for um grupo de produtos negativo (isExluded é verdadeiro).

getStats

Obtém os dados de desempenho deste grupo de produtos.

Para chamar este método, tem de incluir um dos forDateRange métodos na cadeia do seletor do grupo de produtos .

Devolve:

Tipo Descrição
Estatísticas Os dados de desempenho deste grupo de produtos.

getValue

Obtém o valor deste grupo de produtos.

Devolve:

Tipo Descrição
Cadeia O valor deste grupo de produtos. Devolve nulo se este for o grupo raiz.

isExcluded

Obtém um valor Booleano que determina se este grupo de produtos é um grupo de produtos negativo.

Devolve:

Tipo Descrição
Booleano É verdadeiro se este grupo de produtos for um grupo negativo; caso contrário, falso. Por exemplo, em vez de incluir todos os esquis descendentes, exclui-os.

isOtherCase

Obtém um valor Booleano que determina se este grupo de produtos representa tudo o resto não representado pelo respetivo grupo de produtos colaterais (aka., o outro caso).

Devolve:

Tipo Descrição
Booleano É verdadeiro se este grupo de produtos representar o caso "outro"; caso contrário, falso. Por exemplo, se dividir Todos os produtos (o nó raiz) por Bens Desportivos, o serviço cria um grupo de produtos colateral que representa os produtos que não estão em Bens Desportivos e define este campo como verdadeiro. O ID principal deste grupo de produtos e o grupo de produtos Sporting Goods apontam para o nó raiz.

principal

Obtém o principal deste grupo de produtos.

Devolve:

Tipo Descrição
Grupo de Produtos O principal deste grupo de produtos. Devolve nulo se este for o grupo raiz.

setMaxCpc(double cpc)

Define o valor máximo de licitação por clique para este grupo de produtos.

Argumentos

Name Tipo Descrição
cpc duplo O montante da oferta. O valor da oferta está na moeda da conta, que determina os valores mínimos e máximos de licitação que pode especificar. Não defina a oferta se este grupo de produtos for subdividido (tiver filhos) ou for um grupo de produtos negativo (isExcluded é verdadeiro).

Devoluções

Tipo Descrição
vazio Não devolve nada.