REST Resource: advertisers.adGroupAds

Recurso: AdGroupAd

Um único anúncio associado a um grupo de anúncios.

Representação JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
Campos
name

string

O nome de recurso do anúncio.
advertiserId

string (int64 format)

O ID exclusivo do anunciante ao qual o anúncio pertence.
adGroupAdId

string (int64 format)

O ID exclusivo do anúncio. Atribuído pelo sistema.
adGroupId

string (int64 format)

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

string

O nome de exibição do anúncio.

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

enum (EntityStatus)

O status da entidade do anúncio.
adUrls[]

object (AdUrl)

Lista de URLs usados pelo anúncio.
Campo de união ad_details. Os detalhes do anúncio. ad_details pode ser apenas de um dos tipos a seguir:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Detalhes de um anúncio originado de um criativo do Display & Video 360.
mastheadAd

object (MastheadAd)

Detalhes de um anúncio veiculado no feed da página inicial do YouTube.
inStreamAd

object (InStreamAd)

Detalhes de um anúncio in-stream pulável após 5 segundos, usado para reconhecimento da marca ou alcance de objetivos de marketing.
nonSkippableAd

object (NonSkippableAd)

Detalhes de um anúncio em vídeo in-stream curto não pulável, com duração entre 6 e 15 segundos, usado para alcançar objetivos de marketing.
bumperAd

object (BumperAd)

Detalhes de um anúncio em vídeo curto não pulável, com duração igual ou inferior a 6 segundos, usado para alcance.
audioAd

object (AudioAd)

Detalhes de um anúncio em áudio usado para alcançar objetivos de marketing.
videoDiscoverAd

object (VideoDiscoveryAd)

Detalhes de um anúncio que promove um vídeo exibido em locais de descoberta.
videoPerformanceAd

object (VideoPerformanceAd)

Detalhes de um anúncio usado em uma campanha de ação em vídeo para gerar ações para a empresa, serviço ou produto.

DisplayVideoSourceAd

O anúncio originado de um criativo do DV360.

Representação JSON 
{
  "creativeId": string
}
Campos
creativeId

string (int64 format)

O ID do criativo de origem.

MastheadAd

Detalhes de um anúncio de masthead.

Representação JSON 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Campos
video

object (YoutubeVideoDetails)

O vídeo do YouTube usado pelo anúncio.
headline

string

O título do anúncio.
description

string

Descrição do anúncio.
videoAspectRatio

enum (VideoAspectRatio)

A proporção do vídeo do YouTube em reprodução automática no masthead.
autoplayVideoStartMillisecond

string (int64 format)

O tempo em milissegundos após o qual o vídeo vai começar a ser reproduzido.
autoplayVideoDuration

string (Duration format)

A duração do vídeo que será reproduzido automaticamente.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
callToActionButtonLabel

string

O texto no botão de call-to-action.
callToActionFinalUrl

string

O URL de destino do botão de call-to-action.
callToActionTrackingUrl

string

O URL de acompanhamento do botão de call-to-action.
showChannelArt

boolean

Se é necessário mostrar um plano de fundo ou banner que aparece na parte de cima de uma página do YouTube.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Os vídeos que aparecem ao lado do anúncio de masthead no computador. Não pode ser mais de dois.

YoutubeVideoDetails

Detalhes de um vídeo do YouTube.

Representação JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
Campos
id

string

O ID do vídeo do YouTube, que pode ser pesquisado na página da Web do YouTube.
unavailableReason

enum (VideoUnavailableReason)

O motivo pelo qual os dados de vídeo não estão disponíveis.

VideoUnavailableReason

Possíveis motivos para um vídeo ficar indisponível.

Enums
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Desconhecido ou não especificado.
VIDEO_UNAVAILABLE_REASON_PRIVATE O vídeo é particular.
VIDEO_UNAVAILABLE_REASON_DELETED O vídeo foi excluído.

VideoAspectRatio

Possíveis proporções para um vídeo do YouTube.

Enums
VIDEO_ASPECT_RATIO_UNSPECIFIED Não especificado ou desconhecido.
VIDEO_ASPECT_RATIO_WIDESCREEN O vídeo é esticado e as partes de cima e de baixo são cortadas.
VIDEO_ASPECT_RATIO_FIXED_16_9 O vídeo usa uma proporção fixa de 16:9.

InStreamAd

Detalhes de um anúncio in-stream.

Representação JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Campos
commonInStreamAttribute

object (CommonInStreamAttribute)

Atributos comuns de anúncios.
customParameters

map (key: string, value: string)

Os parâmetros personalizados para transmitir valores personalizados ao modelo de URL de rastreamento.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

Atributos comuns para anúncios in-stream, não puláveis e bumper.

Representação JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Campos
displayUrl

string

O endereço da página da Web que aparece com o anúncio.
finalUrl

string

O endereço do URL da página da Web que as pessoas acessam depois de clicar no anúncio.
trackingUrl

string

O endereço do URL carregado em segundo plano para fins de rastreamento.
actionButtonLabel

string

O texto no botão de call-to-action.
actionHeadline

string

O título do banner de call-to-action.
video

object (YoutubeVideoDetails)

O vídeo do YouTube do anúncio.
companionBanner

object (ImageAsset)

A imagem que aparece ao lado do anúncio em vídeo.

ImageAsset

Metadados de um recurso de imagem.

Representação JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
Campos
mimeType

string

Tipo MIME do recurso de imagem.
fullSize

object (Dimensions)

Metadados da imagem no tamanho original.
fileSize

string (int64 format)

Tamanho do arquivo de imagem em bytes.

NonSkippableAd

Detalhes de um anúncio não pulável.

Representação JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Campos
commonInStreamAttribute

object (CommonInStreamAttribute)

Atributos comuns de anúncios.
customParameters

map (key: string, value: string)

Os parâmetros personalizados para transmitir valores personalizados ao modelo de URL de rastreamento.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

Detalhes de um anúncio bumper.

Representação JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Campos
commonInStreamAttribute

object (CommonInStreamAttribute)

Atributos comuns de anúncios.

AudioAd

Detalhes de um anúncio em áudio.

Representação JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Campos
displayUrl

string

O endereço da página da Web que aparece com o anúncio.
finalUrl

string

O endereço do URL da página da Web que as pessoas acessam depois de clicar no anúncio.
trackingUrl

string

O endereço de URL carregado em segundo plano para fins de rastreamento.
video

object (YoutubeVideoDetails)

O vídeo do YouTube do anúncio.

VideoDiscoveryAd

Detalhes de um anúncio Discovery em vídeo.

Representação JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
Campos
headline

string

O título do anúncio.
description1

string

Primeira linha de texto do anúncio.
description2

string

Segunda linha de texto do anúncio.
video

object (YoutubeVideoDetails)

O vídeo do YouTube promovido pelo anúncio.
thumbnail

enum (Thumbnail)

Imagem em miniatura usada no anúncio.

Miniatura

Possíveis opções de miniaturas em anúncios Discovery em vídeo.

Enums
THUMBNAIL_UNSPECIFIED Desconhecido ou não especificado.
THUMBNAIL_DEFAULT A miniatura padrão pode ser gerada automaticamente ou enviada pelo usuário.
THUMBNAIL_1 Miniatura 1, gerada a partir do vídeo.
THUMBNAIL_2 Miniatura 2, gerada a partir do vídeo.
THUMBNAIL_3 Miniatura 3, gerada a partir do vídeo.

VideoPerformanceAd

Detalhes de um anúncio de performance em vídeo.

Representação JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
Campos
finalUrl

string

O endereço do URL da página da Web que as pessoas acessam depois de clicar no anúncio.
trackingUrl

string

O endereço do URL carregado em segundo plano para fins de rastreamento.
actionButtonLabels[]

string

A lista de recursos de texto mostrados no botão de call-to-action.
headlines[]

string

Lista de títulos mostrados no banner de call-to-action.
longHeadlines[]

string

A lista de títulos solitários mostrada no banner de call-to-action.
descriptions[]

string

A lista de descrições mostradas no banner de call-to-action.
displayUrlBreadcrumb1

string

A primeira parte após o domínio no URL de visualização.
displayUrlBreadcrumb2

string

A segunda parte após o domínio no URL de visualização.
domain

string

O domínio do URL de visualização.
videos[]

object (YoutubeVideoDetails)

Lista de recursos de vídeo do YouTube usados pelo anúncio.
customParameters

map (key: string, value: string)

Os parâmetros personalizados para transmitir valores personalizados ao modelo de URL de rastreamento.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanners[]

object (ImageAsset)

A lista de banners complementares usados por este anúncio.

AdUrl

Outros URLs relacionados ao anúncio, incluindo beacons.

Representação JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
Campos
type

enum (AdUrlType)

O tipo do URL do anúncio.
url

string

O valor da string do URL.

AdUrlType

Tipos de URL de anúncio possíveis.

Enums
AD_URL_TYPE_UNSPECIFIED Desconhecido ou não especificado.
AD_URL_TYPE_BEACON_IMPRESSION Um pixel de rastreamento 1 x 1 para dar um ping quando a impressão de um criativo for exibida.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Beacon de impressão expansível do DCM. No momento da veiculação, ele é expandido para vários beacons.
AD_URL_TYPE_BEACON_CLICK URL de rastreamento para fazer ping quando o evento de clique for acionado.
AD_URL_TYPE_BEACON_SKIP URL de rastreamento para ping quando o evento de pulo é acionado.

Métodos

get

 Recebe um anúncio do grupo de anúncios.

list

 Lista os anúncios do grupo de anúncios.