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,
  "adPolicy": {
    object (AdPolicy)
  },
  "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.
adPolicy

object (AdPolicy)

O status de aprovação da política do anúncio.
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.

AdPolicy

Uma única política de publicidade associada a um anúncio de grupo de anúncios.

Representação JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Campos
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

O status de aprovação da política de um anúncio, indicando a decisão de aprovação.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

O status da análise de conformidade com a política de um anúncio, indicando em que etapa do processo de análise ele está.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

As entradas de cada tópico da política identificado como relacionado ao anúncio. Cada entrada inclui o tópico, o nível de restrição e orientações sobre como corrigir problemas de política.

AdPolicyApprovalStatus

Possíveis status de aprovação de uma política de publicidade.

Tipos enumerados
AD_POLICY_APPROVAL_STATUS_UNKNOWN Desconhecido ou não especificado.
DISAPPROVED Não será veiculado.
APPROVED_LIMITED Será veiculado com restrições.
APPROVED Será veiculado sem restrições.
AREA_OF_INTEREST_ONLY Não será veiculado nos países segmentados, mas poderá ser veiculado para usuários que pesquisam informações sobre eles.

AdPolicyReviewStatus

Possíveis status de uma análise de compliance com a política de anúncios.

Tipos enumerados
AD_POLICY_REVIEW_STATUS_UNKNOWN Desconhecido ou não especificado.
REVIEW_IN_PROGRESS Em análise no momento.
REVIEWED Análise principal concluída. Outras revisões ainda podem estar em andamento.
UNDER_APPEAL Foi reenviado para aprovação ou uma decisão relacionada à política foi contestada.
ELIGIBLE_MAY_SERVE Considerado qualificado e pode estar sendo veiculado. Outras análises ainda podem ser feitas.

AdPolicyTopicEntry

Uma entrada que descreve como um anúncio foi identificado como relacionado a uma política de publicidade.

Representação JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Campos
policyTopic

string

O tópico da política.

Por exemplo, "MARCAS COMERCIAIS", "ÁLCOOL" etc.
policyLabel

string

Texto do rótulo localizado para a política.

Por exemplo, "Marcas registradas em texto", "Contém álcool" etc.
policyTopicDescription

string

Uma breve descrição do tema da política.
policyTopicType

enum (AdPolicyTopicEntryType)

Como a veiculação de anúncios será afetada devido à relação com o tema da política de publicidade.
policyDecisionType

enum (AdPolicyDecisionType)

A origem da decisão relacionada à política.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

O método de aplicação da política usado na análise.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

A evidência usada na decisão da política.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

As restrições de veiculação relevantes para a decisão relacionada à política.
appealInfo

object (AdPolicyTopicAppealInfo)

Informações sobre como contestar a decisão relacionada à política.

AdPolicyTopicEntryType

Possíveis impactos na veiculação de um tema da política de publicidade.

Tipos enumerados
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Desconhecido ou não especificado.
PROHIBITED O recurso não será veiculado.
FULLY_LIMITED O recurso não será veiculado em todos os países de destino.
LIMITED O recurso não pode ser veiculado em alguns países.
DESCRIPTIVE O recurso pode veicular.
BROADENING O recurso pode veicular e veicular além da cobertura normal.
AREA_OF_INTEREST_ONLY O recurso é restrito para todos os países de destino, mas pode ser veiculado para usuários que estão pesquisando informações sobre esses países.

AdPolicyDecisionType

Possíveis fontes de uma decisão relacionada à política.

Tipos enumerados
AD_POLICY_DECISION_TYPE_UNKNOWN Desconhecido ou não especificado.
PURSUANT_TO_NOTICE A decisão é de uma notificação judicial, uma ordem judicial, uma reclamação do proprietário do conteúdo da marca registrada etc.
GOOGLE_INVESTIGATION A decisão é de uma investigação do Google.

AdPolicyEnforcementMeans

Possíveis meios de aplicação da política usados na análise.

Tipos enumerados
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Desconhecido ou não especificado.
AUTOMATED O processo de aplicação era totalmente automatizado.
HUMAN_REVIEW Um humano participou parcial ou totalmente do processo de aplicação da decisão.

AdPolicyTopicEvidence

Informações de evidências usadas na decisão da política.

Representação JSON 
{

  // Union field value can be only one of the following:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of list of possible types for union field value.
}
Campos
Campo de união value. A evidência da decisão relacionada à política. value pode ser apenas de um dos tipos a seguir:
textList

object (TextList)

Lista de evidências encontradas no texto do anúncio.
websiteList

object (WebsiteList)

Lista de sites vinculados ao anúncio.
httpCode

integer

Código HTTP retornado quando o URL final foi rastreado.
languageCode

string

O idioma em que o anúncio foi detectado.

Esse campo usa tags de idioma IETF, como "en-US".
destinationTextList

object (DestinationTextList)

O texto no destino do anúncio que está causando uma violação da política.
destinationMismatch

object (DestinationMismatch)

Uma incompatibilidade entre os URLs de destino do anúncio.
destinationNotWorking

object (DestinationNotWorking)

Informações sobre erros de HTTP ou DNS relacionados ao destino do anúncio.
trademark

object (Trademark)

Termos de marca registrada que causaram uma violação da política.
legalRemoval

object (LegalRemoval)

Aplicação de regulamentação relacionada a questões legais que causou uma violação da política.
counterfeit

object (Counterfeit)

A aplicação da política contra pirataria que causou uma violação.
regionalRequirements

object (RegionalRequirements)

Aplicação proativa de T&S que causou uma violação da política.

TextList

Uma lista de fragmentos de texto que violaram a política.

Representação JSON 
{
  "texts": [
    string
  ]
}
Campos
texts[]

string

Os fragmentos de texto do recurso que causaram a descoberta da política.

WebsiteList

Uma lista de sites que violaram a política.

Representação JSON 
{
  "websites": [
    string
  ]
}
Campos
websites[]

string

Sites que causaram a violação da política.

DestinationTextList

Uma lista de texto de destino que violou a política.

Representação JSON 
{
  "destinationTexts": [
    string
  ]
}
Campos
destinationTexts[]

string

Texto de destino que causou a violação da política.

DestinationMismatch

Detalhes sobre uma incompatibilidade entre tipos de URL de destino.

Representação JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Campos
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

O conjunto de URLs que não correspondem. A lista pode incluir um ou vários tipos de URI.

Exemplo 1: [DISPLAY_URL, FINAL_URL] significa que o URL de visualização do anúncio não corresponde ao URL final do anúncio.

Exemplo 2: [FINAL_URL] significa que o URL final do anúncio não corresponde ao URL rastreado, o que também é considerado um destino não correspondente.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Tipos de URL possíveis.

Tipos enumerados
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Não especificado ou desconhecido.
DISPLAY_URL O URL de visualização.
FINAL_URL O URL final.
FINAL_MOBILE_URL O URL final para dispositivos móveis.
TRACKING_URL O URL de rastreamento.
MOBILE_TRACKING_URL O URL de rastreamento para dispositivos móveis.

DestinationNotWorking

Detalhes sobre erros de HTTP ou DNS relacionados ao destino do anúncio.

Representação JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Campos
expandedUri

string

O URL completo que não funcionou.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

O dispositivo em que a visita ao URL resultou no erro.
lastCheckedTime

string (Timestamp format)

A última vez que o erro foi detectado ao navegar até o URL.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
Campo de união reason. O erro HTTP ou de DNS. reason pode ser apenas de um dos tipos a seguir:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

O tipo de erro de DNS.
httpErrorCode

string (int64 format)

O código de erro HTTP.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Possíveis tipos de erros de DNS.

Tipos enumerados
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Não especificado ou desconhecido.
HOSTNAME_NOT_FOUND O nome do host não foi encontrado no DNS ao buscar a página de destino.
GOOGLE_CRAWLER_DNS_ISSUE O Google não conseguiu rastrear a página de destino ao se comunicar com o DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Possíveis dispositivos que encontraram um erro ao acessar o URL.

Tipos enumerados
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Não especificado ou desconhecido.
DESKTOP Dispositivo desktop.
ANDROID Dispositivo Android.
IOS dispositivo iOS.

Marca registrada

Termos de marca registrada que causaram uma violação da política.

Representação JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campos
owner

string

O proprietário do conteúdo da marca registrada.
term

string

O termo da marca registrada.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Países em que a violação da política é relevante.

AdPolicyCriterionRestriction

Representa uma restrição de país.

Representação JSON 
{
  "countryCriterionId": string,
  "countryLabel": string
}
Campos
countryCriterionId

string (int64 format)

O ID do critério de país.
countryLabel

string

Nome localizado do país. Pode estar vazio.

LegalRemoval

Aplicação de regulamentações relacionadas a questões legais, seja da DMCA ou de regulamentações legais locais.

Representação JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
Campos
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

O tipo de petição inicial que causou a remoção judicial.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Os países restritos devido à remoção legal.
restrictedUris[]

string

Os URLs restritos devido à remoção legal.
Campo de união type. Detalhes sobre o tipo de remoção judicial. type pode ser apenas de um dos tipos a seguir:
dmca

object (Dmca)

Detalhes sobre a remoção judicial da regulamentação da DMCA.

DMCA

Detalhes da denúncia com base na DMCA.

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

string

A entidade que fez a denúncia por motivos jurídicos.

LocalLegal

Detalhes da regulamentação jurídica local.

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

string

Tipo de legislação para o aviso legal.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Possíveis tipos de denúncia para remoção judicial.

Tipos enumerados
COPYRIGHT

Direitos autorais.

Válido apenas para a DMCA.
COURT_ORDER

Mandado judicial.

Válido apenas para legislação local.

Falsificação

Detalhes sobre a aplicação da lei contra pirataria que causou uma violação da política.

Representação JSON 
{
  "owners": [
    string
  ]
}
Campos
owners[]

string

Os proprietários do conteúdo ou produto que fizeram uma denúncia.

RegionalRequirements

Aplicação proativa de confiança e segurança (T&S) para políticas destinadas a atender aos requisitos regionais. Isso é considerado uma investigação do Google em vez de uma notificação de regulamentação, já que é uma aplicação proativa dos T&S.

Representação JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Campos
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Lista de requisitos regionais.

RegionalRequirementsEntry

Detalhes da violação legal regional no nível da política.

Representação JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campos
legalPolicy

string

A política jurídica que está sendo violada.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Os países restritos devido à política jurídica.

AdPolicyTopicConstraint

Detalhes sobre restrições de veiculação de anúncios.

Representação JSON 
{
  "requestCertificateFormLink": string,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
Campos
Campo de união constraint. A restrição de veiculação. constraint pode ser apenas de um dos tipos a seguir:
countryConstraint

object (AdPolicyCountryConstraintList)

Países onde o anúncio não pode ser veiculado.
resellerConstraint

object (AdPolicyResellerConstraint)

Restrição do revendedor.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Países em que um certificado é necessário para veiculação.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Países em que o domínio do recurso não é coberto pelos certificados associados a ele.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

O certificado é obrigatório para veiculação em qualquer país.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

O certificado é obrigatório para veiculação em qualquer país, e o certificado atual não cobre o domínio do anúncio.

AdPolicyCountryConstraintList

Uma lista de países em que o anúncio não pode ser veiculado devido a restrições da política.

Representação JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campos
countries[]

object (AdPolicyCriterionRestriction)

Países onde o anúncio não pode ser veiculado.

AdPolicyResellerConstraint

Esse tipo não tem campos.

O tema da política foi restrito devido à reprovação do site para fins de revenda.

AdPolicyGlobalCertificateMissingConstraint

Esse tipo não tem campos.

O certificado é obrigatório para veiculação em qualquer país.

AdPolicyGlobalCertificateDomainMismatchConstraint

Esse tipo não tem campos.

O certificado é obrigatório para veiculação em qualquer país, e o certificado atual não cobre o domínio do anúncio.

AdPolicyTopicAppealInfo

Informações sobre como contestar uma decisão baseada na política.

Representação JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Campos
appealType

enum (AdPolicyAppealType)

Se a decisão pode ser contestada por um formulário ou um processo de autoatendimento.

AdPolicyAppealType

Possíveis tipos de contestação.

Tipos enumerados
AD_POLICY_APPEAL_TYPE_UNKNOWN Desconhecido ou não especificado.
SELF_SERVICE_APPEAL A decisão pode ser contestada por um processo de autoatendimento.
APPEAL_FORM A decisão pode ser contestada usando um formulário de contestação.

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 únicos 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.