REST Resource: advertisers.adGroups

Recurso: AdGroup

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 a que 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 a que 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. Apenas o campo youtubeAndPartnersBid pode ser usado na estratégia de lances.
entityStatus

enum (EntityStatus)

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

Se o item de linha principal do grupo de anúncios não estiver ativo, o grupo não poderá gastar o orçamento, mesmo que o status dele seja 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 neste grupo de anúncios.

AdGroupFormat

O formato do grupo de anúncios.

Tipos enumerados
AD_GROUP_FORMAT_UNSPECIFIED O valor do formato não foi 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 de áudio in-stream não puláveis.
AD_GROUP_FORMAT_RESPONSIVE Anúncios responsivos.
AD_GROUP_FORMAT_REACH Grupos de anúncios de alcance efetivo, incluindo anúncios in-stream e bumper.
AD_GROUP_FORMAT_MASTHEAD Anúncio de masthead que aparece no espaç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 produtos são selecionados pelo feed de produtos.
productMatchDimensions[]

object (ProductMatchDimension)

Uma lista de dimensões usadas para corresponder a produtos.
isFeedDisabled

boolean

Se o feed de produtos desativou a exibição de produtos.

ProductMatchType

Os tipos de maneiras de corresponder produtos.

Tipos enumerados
PRODUCT_MATCH_TYPE_UNSPECIFIED Não especificado ou desconhecido.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Todos os produtos são correspondentes.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Produtos específicos estão selecionados.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Combine 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 em que o produto será correspondido. dimension pode ser apenas de um dos tipos a seguir:
productOfferId

string

O ID da oferta de produto a ser correspondida com um produto com o mesmo ID de oferta.
customLabel

object (CustomLabel)

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

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

Tipos enumerados
CUSTOM_LABEL_KEY_UNSPECIFIED Não especificado ou desconhecido.
CUSTOM_LABEL_KEY_0 Índice de chave 0.
CUSTOM_LABEL_KEY_1 Índice de chaves 1.
CUSTOM_LABEL_KEY_2 Índice de chaves 2.
CUSTOM_LABEL_KEY_3 Índice de chaves 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.