REST Resource: advertisers.adGroupAds

{
  "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.
}

string

O nome de recurso do anúncio.

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

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

enum (EntityStatus)

O status da entidade do anúncio.

object (AdUrl)

Lista de URLs usados pelo anúncio.

object (DisplayVideoSourceAd)

Detalhes de um anúncio proveniente de uma Rede de Display Criativo do Video 360.

object (MastheadAd)

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

object (InStreamAd)

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

object (NonSkippableAd)

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

object (BumperAd)

Detalhes de um anúncio em vídeo curto não pulável, igual ou menor que 6 segundos, usado para alcance.

object (AudioAd)

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

object (VideoDiscoveryAd)

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

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.

{
  "creativeId": string
}

string (int64 format)

O ID do criativo de origem.

{
  "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)
    }
  ]
}

object (YoutubeVideoDetails)

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

string

O título do anúncio.

string

Descrição do anúncio.

enum (VideoAspectRatio)

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

string (int64 format)

O tempo, em milissegundos, para começar a reprodução do vídeo.

string (Duration format)

O tempo de reprodução automática do vídeo.

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

string

O texto do botão de call-to-action.

string

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

string

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

boolean

Indica se um plano de fundo ou um banner que aparece na parte superior de uma página do YouTube será mostrado.

object (YoutubeVideoDetails)

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

{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}

string

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

enum (VideoUnavailableReason)

Motivo pelo qual os dados do vídeo não estão disponíveis.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

Atributos comuns de anúncios.

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" }.

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}

string

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

string

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

string

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

string

O texto do botão de call-to-action.

string

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

object (YoutubeVideoDetails)

O vídeo do YouTube do anúncio.

object (ImageAsset)

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

{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}

string

Tipo MIME do recurso de imagem.

object (Dimensions)

Metadados desta imagem em tamanho original.

string (int64 format)

É o tamanho do arquivo do recurso de imagem em bytes.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

Atributos comuns de anúncios.

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": {
    object (CommonInStreamAttribute)
  }
}

object (CommonInStreamAttribute)

Atributos comuns de anúncios.

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}

string

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

string

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

string

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

object (YoutubeVideoDetails)

O vídeo do YouTube do anúncio.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}

string

Título do anúncio.

string

Primeira linha de texto do anúncio.

string

Segunda linha de texto do anúncio.

object (YoutubeVideoDetails)

O vídeo do YouTube que o anúncio promove.

enum (Thumbnail)

Imagem em miniatura usada no anúncio.

{
  "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)
    }
  ]
}

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

Segunda parte após o domínio no URL de visualização.

string

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

object (YoutubeVideoDetails)

A lista de recursos de vídeo do YouTube usados por este anúncio.

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" }.

object (ImageAsset)

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

{
  "type": enum (AdUrlType),
  "url": string
}

enum (AdUrlType)

O tipo de URL do anúncio.

string

O valor da string do URL.