REST Resource: advertisers.adGroups

Recurso: grupo de anúncios

É um único grupo de anúncios associado a um item de linha.

Representação JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Campos
name

string

O nome do recurso do grupo de anúncios.
advertiserId

string (int64 format)

O ID exclusivo do anunciante ao qual o grupo de anúncios pertence.
adGroupId

string (int64 format)

O ID exclusivo do grupo de anúncios. Atribuído pelo sistema.
lineItemId

string (int64 format)

O ID exclusivo do item de linha ao qual o grupo de anúncios pertence.
displayName

string

O nome de exibição do grupo de anúncios.

Precisa ser codificado em UTF-8 com um tamanho máximo de 255 bytes.
adGroupFormat

enum (AdGroupFormat)

O formato dos anúncios no grupo de anúncios.
bidStrategy

object (BiddingStrategy)

A estratégia de lances usada pelo grupo de anúncios. Somente o campo youtubeAndPartnersBid pode ser usado na estratégia de lances.
entityStatus

enum (EntityStatus)

Controla se o grupo de anúncios pode ou não gastar o orçamento e dar lances no inventário.

Se o item de linha pai do grupo de anúncios não estiver ativo, o grupo não poderá gastar o orçamento, mesmo que tenha o próprio status ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

As configurações de segmentação otimizada do grupo de anúncios.
productFeedData

object (ProductFeedData)

As configurações do feed de produtos deste grupo de anúncios.

AdGroupFormat

Formato do grupo de anúncios.

Enums
AD_GROUP_FORMAT_UNSPECIFIED O valor do formato não é especificado ou é desconhecido nesta versão.
AD_GROUP_FORMAT_IN_STREAM Anúncios in-stream.
AD_GROUP_FORMAT_VIDEO_DISCOVERY Anúncios In-feed.
AD_GROUP_FORMAT_BUMPER Anúncios bumper.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Anúncios in-stream não puláveis.
AD_GROUP_FORMAT_AUDIO Anúncios em áudio in-stream não puláveis.
AD_GROUP_FORMAT_RESPONSIVE Anúncios responsivos.
AD_GROUP_FORMAT_REACH Grupos de anúncios de alcance eficaz, incluindo anúncios in-stream e bumper.
AD_GROUP_FORMAT_MASTHEAD Anúncio de masthead que aparece na posição superior da página inicial do YouTube.

ProductFeedData

Os detalhes do feed de produtos.

Representação JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Campos
productMatchType

enum (ProductMatchType)

Como os itens são selecionados pelo feed de produtos.
productMatchDimensions[]

object (ProductMatchDimension)

Uma lista de dimensões usadas para fazer a correspondência entre os produtos.
isFeedDisabled

boolean

Indica se o feed de produtos desativou a exibição de produtos.

ProductMatchType

Os tipos de correspondência de produtos.

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED Não especificado ou desconhecido.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Todos os produtos foram correspondidos.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Produtos específicos são selecionados.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Relacione os produtos pelos rótulos personalizados.

ProductMatchDimension

Uma dimensão usada para corresponder produtos.

Representação JSON 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Campos
Campo de união dimension. A dimensão e o valor correspondentes ao produto. dimension pode ser apenas de um dos tipos a seguir:
productOfferId

string

O ID da oferta de produto que corresponde a um produto com o mesmo ID de oferta.
customLabel

object (CustomLabel)

O rótulo personalizado para corresponder a todos os produtos a ela.

CustomLabel

A chave e o valor de um rótulo personalizado.

Representação JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Campos
key

enum (CustomLabelKey)

A chave do rótulo.
value

string

O valor do rótulo.

CustomLabelKey

A chave do rótulo personalizado

Enums
CUSTOM_LABEL_KEY_UNSPECIFIED Não especificado ou desconhecido.
CUSTOM_LABEL_KEY_0 Índice de chave 0.
CUSTOM_LABEL_KEY_1 Índice de chave 1.
CUSTOM_LABEL_KEY_2 Índice de chaves 2.
CUSTOM_LABEL_KEY_3 Índice de chave 3.
CUSTOM_LABEL_KEY_4 Índice de chaves 4.

Métodos

bulkListAdGroupAssignedTargetingOptions

 Lista as opções de segmentação atribuídas a vários grupos de anúncios em diferentes tipos de segmentação.

get

 Recebe um grupo de anúncios.

list

 Lista os grupos de anúncios.