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 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. 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 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 nesse grupo de anúncios.

AdGroupFormat

O formato do grupo de anúncios.

Enums
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 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 efetivo, incluindo anúncios in-stream e bumper.
AD_GROUP_FORMAT_MASTHEAD Anúncio de masthead que aparece no espaço principal 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 produtos.
isFeedDisabled

boolean

Se o feed de produtos está desativado para mostrar produtos.

ProductMatchType

Os tipos de maneiras de corresponder 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 Combine produtos por rótulos personalizados.

ProductMatchDimension

Uma dimensão usada para fazer correspondência de 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 que correspondem ao produto. dimension pode ser apenas de um dos tipos a seguir:
productOfferId

string

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

object (CustomLabel)

O rótulo personalizado que corresponde 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

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

Métodos

bulkListAdGroupAssignedTargetingOptions

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

get

 Recebe um grupo de anúncios.

list

 Lista grupos de anúncios.