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 do recurso do anúncio.
advertiserId

string (int64 format)

O ID exclusivo do anunciante a que 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 a que 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 objetivos de marketing de reconhecimento da marca ou alcance.
nonSkippableAd

object (NonSkippableAd)

Detalhes de um anúncio em vídeo in-stream curto não pulável, entre 6 e 15 segundos, usado para objetivos de marketing de alcance.
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 e aparece 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, o serviço ou o produto.

DisplayVideoSourceAd

O anúncio foi criado com 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 com 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 tempo em que o vídeo 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 rastreamento do botão de call-to-action.
showChannelArt

boolean

Se você quer 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 que 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 não estar disponível.

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

VideoAspectRatio

Proporções possíveis para um vídeo do YouTube.

Tipos enumerados
VIDEO_ASPECT_RATIO_UNSPECIFIED Não especificado ou desconhecido.
VIDEO_ASPECT_RATIO_WIDESCREEN O vídeo está esticado, e as partes de cima e de baixo estã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 da página da Web que as pessoas acessam depois de clicar no anúncio.
trackingUrl

string

O endereço 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 do recurso 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 da página da Web que as pessoas acessam depois de clicar no anúncio.
trackingUrl

string

O endereço 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 que o anúncio promove.
thumbnail

enum (Thumbnail)

Imagem em miniatura usada no anúncio.

Miniatura

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

Tipos enumerados
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 com base no vídeo.
THUMBNAIL_2 Miniatura 2, gerada com base no vídeo.
THUMBNAIL_3 Miniatura 3, gerada com base no 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 da página da Web que as pessoas acessam depois de clicar no anúncio.
trackingUrl

string

O endereço 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

A lista de manchetes mostradas no banner de call-to-action.
longHeadlines[]

string

A lista de títulos independentes mostrados 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 depois do domínio no URL de visualização.
displayUrlBreadcrumb2

string

A segunda parte depois do domínio no URL de visualização.
domain

string

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

object (YoutubeVideoDetails)

A lista de recursos de vídeo do YouTube usados por este 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

URLs adicionais 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

Possíveis tipos de URL do anúncio.

Tipos enumerados
AD_URL_TYPE_UNSPECIFIED Desconhecido ou não especificado.
AD_URL_TYPE_BEACON_IMPRESSION Um pixel de rastreamento 1 x 1 para enviar um ping quando uma impressão de um criativo é veiculada.
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 ping quando o evento de clique é acionado.
AD_URL_TYPE_BEACON_SKIP URL de rastreamento para pingar quando o evento de pular for acionado.

Métodos

get

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

list

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