REST Resource: advertisers.youtubeAdGroups

Recurso: YoutubeAnúncios

Um único grupo de anúncios do YouTube associado a um item de linha do YouTube e parceiros.

Representação JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "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.

Ser codificado em UTF-8 com um tamanho máximo de 255 bytes.
youtubeAdIds[]

string (int64 format)

Os IDs dos recursos [youtube_ad_group_ad][] associados ao grupo de anúncios.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

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

object (YoutubeAndPartnersBiddingStrategy)

A estratégia de lances usada pelo grupo de anúncios.
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, esse grupo não poderá gastar o orçamento, mesmo que tenha o status ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

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

Essa configuração só é aplicável quando a segmentação de listas de público-alvo qualificadas é atribuída ao grupo de anúncios.
productFeedData

object (ProductFeedData)

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

YoutubeAndPartnersAdGroupFormat

O formato do grupo de anúncios do YouTube.

Enums
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED O valor do formato não foi especificado ou é desconhecido nesta versão.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Anúncios in-stream.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Anúncios In-feed.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Anúncios bumper.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Anúncios in-stream não puláveis.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Anúncios em áudio in-stream não puláveis.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Anúncios responsivos para campanhas de ação em vídeo.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Grupos de anúncios de alcance efetivo, incluindo anúncios in-stream e bumper.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Anúncio de masthead que é exibido 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 de produtos.
isFeedDisabled

boolean

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 são correspondidos.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Produtos específicos são selecionados.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Faça a correspondência dos produtos pelos rótulos personalizados.

ProductMatchDimension

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

string

O código da oferta de produto que corresponde a um produto com o mesmo código 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

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 chave 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 a vários grupos de anúncios do YouTube em diferentes tipos de segmentação.

get

 Recebe um grupo de anúncios do YouTube.

list

 Lista os grupos de anúncios do YouTube.