REST Resource: customers.ads

FinalAppUrl

É um URL de link direto para um app de acordo com o sistema operacional em questão.

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

enum (AppUrlOperatingSystemType)

O sistema operacional segmentado por este URL. Obrigatório.
url

string

URL do link direto do aplicativo. Os links diretos especificam um local em um app que corresponde ao conteúdo que você quer mostrar e precisam ter o formato {scheme}://{host_path}. O esquema identifica qual app abrir. Para seu app, você pode usar um esquema personalizado que comece com o nome dele. O host e o caminho especificam o local no app em que seu conteúdo se encontra. Exemplo: "exampleapp://productid_1234". Obrigatório.

AppUrlOperatingSystemType

Sistema operacional

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
IOS O sistema operacional Apple IOS.
ANDROID O sistema operacional Android.

CustomParameter

Um mapeamento que pode ser usado por tags de parâmetros personalizados em um trackingUrlTemplate, finalUrls ou mobile_final_urls.

Representação JSON 
{
  "key": string,
  "value": string
}
Campos
key

string

A chave que corresponde ao nome da tag do parâmetro.
value

string

O valor a ser substituído.

AdType

Os tipos possíveis de um anúncio.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
TEXT_AD Esse é um anúncio de texto.
EXPANDED_TEXT_AD Este é um anúncio de texto expandido.
EXPANDED_DYNAMIC_SEARCH_AD É um anúncio dinâmico expandido de pesquisa.
HOTEL_AD O anúncio é de hotel.
SHOPPING_SMART_AD Esse é um anúncio inteligente do Shopping.
SHOPPING_PRODUCT_AD Este é um anúncio padrão do Shopping.
VIDEO_AD Este é um anúncio em vídeo.
IMAGE_AD Este é um anúncio gráfico.
RESPONSIVE_SEARCH_AD Este é um anúncio responsivo de pesquisa.
LEGACY_RESPONSIVE_DISPLAY_AD É um anúncio responsivo de display legado.
APP_AD Esse é um anúncio de app.
LEGACY_APP_INSTALL_AD Trata-se de um anúncio legado de instalação de apps.
RESPONSIVE_DISPLAY_AD Esse é um anúncio responsivo de display.
LOCAL_AD Este é um anúncio local.
HTML5_UPLOAD_AD Este é um anúncio de upload de display com o tipo de produto HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Este é um anúncio gráfico de upload com um dos tipos de produto DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Trata-se de um anúncio de engajamento no app.
SHOPPING_COMPARISON_LISTING_AD Este é um anúncio de comparadores do Shopping.
VIDEO_BUMPER_AD Anúncio bumper em vídeo.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Anúncio em vídeo in-stream não pulável.
VIDEO_OUTSTREAM_AD Anúncio em vídeo out-stream.
VIDEO_TRUEVIEW_IN_STREAM_AD Anúncio TrueView in-stream em vídeo.
VIDEO_RESPONSIVE_AD Anúncio responsivo em vídeo.
SMART_CAMPAIGN_AD Anúncio da campanha inteligente.
CALL_AD Anúncio de chamada.
APP_PRE_REGISTRATION_AD É o anúncio universal de pré-registro do app.
IN_FEED_VIDEO_AD anúncio em vídeo In-feed.
DISCOVERY_MULTI_ASSET_AD Anúncio Discovery com vários recursos.
TRAVEL_AD Anúncio de viagens.
DISCOVERY_VIDEO_RESPONSIVE_AD Anúncio Discovery em vídeo.

Dispositivo

Enumera os dispositivos do Google Ads disponíveis para segmentação.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
MOBILE Dispositivos móveis com navegadores completos.
TABLET Tablets com navegadores completos.
DESKTOP Computadores.
CONNECTED_TV Smart TVs e consoles de jogos.
OTHER Outros tipos de dispositivos.

UrlCollection

Coleção de URLs marcados com um identificador exclusivo.

Representação JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Campos
finalUrls[]

string

Uma lista de possíveis URLs finais.
finalMobileUrls[]

string

Uma lista de possíveis URLs finais para dispositivos móveis.
urlCollectionId

string

Identificador exclusivo dessa instância de UrlCollection.
trackingUrlTemplate

string

Modelo de URL para criar um URL de rastreamento.

SystemManagedResourceSource

Enumeração que lista as possíveis origens de entidades gerenciadas pelo sistema.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
AD_VARIATIONS Anúncio do experimento de variações do anúncio gerado.

TextAdInfo

Um anúncio de texto.

Representação JSON 
{
  "headline": string,
  "description1": string,
  "description2": string
}
Campos
headline

string

Título do anúncio.
description1

string

A primeira linha da descrição do anúncio.
description2

string

Segunda linha da descrição do anúncio.

ExpandedTextAdInfo

Anúncio de texto expandido.

Representação JSON 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Campos
headlinePart1

string

A primeira parte do título do anúncio.
headlinePart2

string

A segunda parte do título do anúncio.
headlinePart3

string

A terceira parte do título do anúncio.
description

string

Descrição do anúncio.
description2

string

A segunda descrição do anúncio.
path1

string

O texto que pode aparecer ao lado do URL exibido do anúncio.
path2

string

Texto adicional que pode aparecer ao lado do URL exibido do anúncio.

CallAdInfo

Anúncio de chamada.

Representação JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Campos
countryCode

string

O código do país no anúncio.
phoneNumber

string

É o número de telefone do anúncio.
businessName

string

Nome da empresa no anúncio.
headline1

string

Primeiro título no anúncio.
headline2

string

Segundo título do anúncio.
description1

string

A primeira linha da descrição do anúncio.
description2

string

Segunda linha da descrição do anúncio.
callTracked

boolean

Define se o rastreamento de chamadas para o criativo será ativado. Ativar o acompanhamento de chamadas também ativa as conversões de chamada.
disableCallConversion

boolean

Indica se a conversão de chamada do criativo será desativada. Se definido como true, as conversões de chamada serão desativadas mesmo quando callTracked for true. Se callTracked for false, este campo será ignorado.
phoneNumberVerificationUrl

string

O URL a ser usado para a verificação do número de telefone.
conversionAction

string

A ação de conversão à qual atribuir uma conversão de chamada. Se ela não for definida, uma ação de conversão padrão será usada. Este campo só tem efeito se callTracked estiver definido como true. Caso contrário, esse campo será ignorado.
conversionReportingState

enum (CallConversionReportingState)

O comportamento de conversão de chamada desse anúncio de chamada. Ela pode usar a própria configuração de conversões de chamada, herdar a configuração no nível da conta ou ser desativada.
path1

string

Primeira parte do texto que pode ser anexada ao URL no anúncio. Opcional.
path2

string

Segunda parte do texto que pode ser anexada ao URL no anúncio. Só é possível definir este campo quando path1 também está definido. Opcional.

CallConversionReportingState

Possíveis tipos de dados para um estado de ação de conversão de chamada.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
DISABLED A ação de conversão de chamada está desativada.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION A ação de conversão de chamada vai usar o tipo de conversão de chamada definido no nível da conta.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION A ação de conversão de chamada usará o tipo de conversão de chamada definido no nível do recurso (anúncios só para chamadas/extensões de chamada).

ExpandedDynamicSearchAdInfo

Um anúncio dinâmico expandido de pesquisa.

Representação JSON 
{
  "description": string,
  "description2": string
}
Campos
description

string

Descrição do anúncio.
description2

string

A segunda descrição do anúncio.

HotelAdInfo

Esse tipo não tem campos.

Um anúncio de hotel.

ShoppingSmartAdInfo

Esse tipo não tem campos.

Um anúncio inteligente do Shopping

ShoppingProductAdInfo

Esse tipo não tem campos.

Um anúncio padrão do Shopping

ImageAdInfo

Anúncio de imagem.

Representação JSON 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Campos
mimeType

enum (MimeType)

O tipo MIME da imagem.
pixelWidth

string (int64 format)

Largura em pixels da imagem em tamanho original.
pixelHeight

string (int64 format)

Altura em pixels da imagem em tamanho original.
imageUrl

string

A URL da imagem em tamanho original.
previewPixelWidth

string (int64 format)

Largura em pixels da imagem com tamanho de visualização.
previewPixelHeight

string (int64 format)

Altura em pixels da imagem com tamanho de visualização.
previewImageUrl

string

URL da imagem do tamanho da visualização.
name

string

O nome da imagem. Se a imagem foi criada a partir de um MediaFile, esse é o nome do MediaFile. Se a imagem foi criada com base em bytes, o nome estará vazio.
Campo de união image. A imagem a partir da qual o ImageAd será criado. Isso pode ser especificado de duas maneiras. 1. Um recurso MediaFile existente. 2. Os dados brutos da imagem como bytes. image pode ser apenas de um dos tipos a seguir:
mediaFile

string

O recurso MediaFile a ser usado para a imagem.
data

string (bytes format)

Dados brutos da imagem como bytes.

Uma string codificada em base64.
adIdToCopyImageFrom

string (int64 format)

Um ID do anúncio do qual a imagem será copiada.

MimeType

O tipo MIME

Enums
UNSPECIFIED O tipo MIME não foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
IMAGE_JPEG Tipo MIME de imagem/jpeg.
IMAGE_GIF Tipo MIME de imagem/gif.
IMAGE_PNG Tipo MIME de imagem/png.
FLASH Tipo MIME de aplicativo/x-shockwave-flash.
TEXT_HTML Tipo MIME de texto/html.
PDF Tipo MIME de aplicativo/pdf.
MSWORD Tipo MIME de aplicativo/msword.
MSEXCEL Tipo MIME de application/vnd.ms-excel.
RTF Tipo MIME de aplicativo/rtf.
AUDIO_WAV Tipo MIME de áudio/wav.
AUDIO_MP3 Tipo MIME de áudio/mp3.
HTML5_AD_ZIP Tipo MIME de application/x-html5-ad-zip.

VideoAdInfo

Um anúncio em vídeo.

Representação JSON 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Campos
video

object (AdVideoAsset)

Os recursos de vídeo do YouTube usados para o anúncio.
Campo de união format. Esquema específico para os diferentes formatos de vídeo. format pode ser apenas de um dos tipos a seguir:
inStream

object (VideoTrueViewInStreamAdInfo)

Formato de anúncio em vídeo TrueView in-stream.
bumper

object (VideoBumperInStreamAdInfo)

Formato de anúncio bumper em vídeo in-stream.
outStream

object (VideoOutstreamAdInfo)

Formato de anúncio em vídeo out-stream.
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Formato de anúncio em vídeo in-stream não pulável.
inFeed

object (InFeedVideoAdInfo)

formato do anúncio em vídeo In-feed.

AdVideoAsset

Um recurso de vídeo usado em um anúncio.

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

string

O nome do recurso do recurso deste vídeo.

VideoTrueViewInStreamAdInfo

Representação do formato de anúncio em vídeo TrueView in-stream (anúncio mostrado durante a reprodução do vídeo, geralmente no início, que exibe um botão "Pular" alguns segundos depois do início do vídeo).

Representação JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
Campos
actionButtonLabel

string

Rótulo no botão de CTA (call-to-action) que leva o usuário ao URL final do anúncio em vídeo. Obrigatório para campanhas TrueView for Action. Caso contrário, é opcional.
actionHeadline

string

Texto adicional exibido com o botão de CTA (call-to-action) para dar contexto e incentivar o clique no botão.
companionBanner

object (AdImageAsset)

Os recursos de imagem do banner complementar usados com o anúncio.

AdImageAsset

Um recurso de imagem usado em um anúncio.

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

string

O nome do recurso do recurso desta imagem.

VideoBumperInStreamAdInfo

Representação do formato de anúncio bumper em vídeo in-stream (anúncio em vídeo in-stream não pulável muito curto).

Representação JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Campos
companionBanner

object (AdImageAsset)

Os recursos de imagem do banner complementar usados com o anúncio.
actionButtonLabel

string

Rótulo no botão "Call-to-action" que leva o usuário ao URL final do anúncio em vídeo.
actionHeadline

string

Texto adicional exibido com o botão de CTA (call-to-action) para dar contexto e incentivar o clique no botão.

VideoOutstreamAdInfo

Representação do formato do anúncio em vídeo out-stream (exibido ao lado de um feed com reprodução automática, sem som).

Representação JSON 
{
  "headline": string,
  "description": string
}
Campos
headline

string

Título do anúncio.
description

string

A linha de descrição.

VideoNonSkippableInStreamAdInfo

Representação do formato de anúncio em vídeo in-stream não pulável (anúncio em vídeo in-stream não pulável de 15 segundos).

Representação JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Campos
companionBanner

object (AdImageAsset)

Os recursos de imagem do banner complementar usados com o anúncio.
actionButtonLabel

string

Rótulo no botão "Call-to-action" que leva o usuário ao URL final do anúncio em vídeo.
actionHeadline

string

Texto adicional exibido com o botão "Call-to-action" para dar contexto e incentivar o clique no botão.

InFeedVideoAdInfo

Representação do formato do anúncio em vídeo In-feed.

Representação JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
Campos
headline

string

Título do anúncio.
description1

string

Primeira linha de texto do anúncio.
description2

string

Segunda linha de texto do anúncio.
thumbnail

enum (VideoThumbnail)

Imagem da miniatura do vídeo a ser usada.

VideoThumbnail

Enumeração que lista os tipos possíveis de uma miniatura de vídeo.

Enums
UNSPECIFIED O tipo não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta.
DEFAULT_THUMBNAIL A miniatura padrão. Podem ser gerados automaticamente ou enviados 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.

VideoResponsiveAdInfo

Um anúncio responsivo em vídeo.

Representação JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto usados no título curto. No momento, somente um valor para o título curto é compatível.
longHeadlines[]

object (AdTextAsset)

Lista de recursos de texto usados no título longo. No momento, somente um valor para o título longo é aceito.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto usados na descrição. No momento, só há suporte para um valor para a descrição.
callToActions[]

object (AdTextAsset)

Lista de recursos de texto usados para o botão, por exemplo, o botão "Call-to-action". Atualmente, apenas um valor para o botão é suportado.
videos[]

object (AdVideoAsset)

A lista dos recursos de vídeo do YouTube usados para o anúncio. Atualmente, só há suporte para um valor para o recurso de vídeo do YouTube.
companionBanners[]

object (AdImageAsset)

Lista de recursos de imagem usados no banner complementar. Atualmente, somente um valor para o recurso de banner complementar é compatível.
breadcrumb1

string

Primeira parte do texto que aparece no anúncio com o URL exibido.
breadcrumb2

string

Segunda parte do texto que aparece no anúncio com o URL exibido.

AdTextAsset

Um recurso de texto usado em um anúncio.

Representação JSON 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
Campos
pinnedField

enum (ServedAssetFieldType)

O campo fixado do recurso. Isso restringe o recurso a ser exibido apenas nesse campo. Vários recursos podem ser fixados no mesmo campo. Um recurso liberado ou fixado em um campo diferente não será veiculado em um campo em que algum outro recurso foi fixado.
assetPerformanceLabel

enum (AssetPerformanceLabel)

O rótulo de desempenho desse recurso de texto.
policySummaryInfo

object (AdAssetPolicySummary)

O resumo da política deste recurso de texto.
text

string

Texto do recurso.

ServedAssetFieldType

Os possíveis tipos de campo de recursos.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
HEADLINE_1 O recurso é usado no título 1.
HEADLINE_2 O recurso é usado no título 2.
HEADLINE_3 O recurso é usado no título 3.
DESCRIPTION_1 O recurso é usado na descrição 1.
DESCRIPTION_2 O recurso é usado na descrição 2.
CALL Este recurso é usado como uma chamada.
MOBILE_APP Este recurso é usado como um app para dispositivos móveis.
CALLOUT Esse recurso é usado como frase de destaque.
STRUCTURED_SNIPPET Esse recurso é usado como um snippet estruturado.
PRICE Esse recurso é usado como preço.
PROMOTION Este recurso é usado como promoção.
AD_IMAGE Este recurso é usado como imagem.
LEAD_FORM O recurso é usado como formulário de lead.

AssetPerformanceLabel

Enumeração que descreve os possíveis rótulos de desempenho de um ativo, normalmente calculados no contexto de uma vinculação.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
PENDING Este recurso ainda não tem informações de desempenho. Isso pode ter acontecido porque ele ainda está em revisão.
LEARNING O recurso começou a receber impressões, mas as estatísticas não têm significância estatística o suficiente para receber um rótulo de performance de recurso.
LOW Recursos com pior performance.
GOOD Recursos com boa performance.
BEST Recursos com melhor performance.

AdAssetPolicySummary

Contém informações de política para um recurso dentro de um anúncio.

Representação JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Campos
policyTopicEntries[]

object (PolicyTopicEntry)

A lista de descobertas de política para este recurso.
reviewStatus

enum (PolicyReviewStatus)

Em que ponto do processo de revisão esse recurso está.
approvalStatus

enum (PolicyApprovalStatus)

O status geral de aprovação deste recurso, que é calculado com base no status das entradas individuais do tópico da política.

PolicyTopicEntry

Descoberta de política anexada a um recurso (por exemplo, política de bebidas alcoólicas associada a um site que vende bebidas alcoólicas).

Cada PolicyTopicEntry tem um tópico que indica a política de anúncios específica da entrada e um tipo que indica o efeito que ela terá na veiculação. Ele pode, opcionalmente, ter uma ou mais evidências que indicam o motivo da descoberta. Ela também pode ter uma ou mais restrições que fornecem detalhes sobre como a veiculação pode ser restrita.

Representação JSON 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
Campos
type

enum (PolicyTopicEntryType)

Descreve o efeito negativo ou positivo que essa política terá na veiculação.
evidences[]

object (PolicyTopicEvidence)

Informações adicionais que explicam a descoberta da política (por exemplo, o nome da marca para uma descoberta de marca registrada)
constraints[]

object (PolicyTopicConstraint)

Indica como a veiculação deste recurso pode ser afetada (por exemplo, não exibição em um país).
topic

string

Tópico de política a que esta descoberta se refere. Por exemplo, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT" ou "DESTINATION_NOT_WORKING". O conjunto de possíveis tópicos de política não é fixo para uma determinada versão da API e pode mudar a qualquer momento.

PolicyTopicEntryType

Os possíveis tipos de entrada do tópico da política.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
PROHIBITED O recurso não será exibido.
LIMITED O recurso não será exibido em algumas circunstâncias.
FULLY_LIMITED O recurso não pode ser exibido devido aos critérios de segmentação atuais.
DESCRIPTIVE Pode ser interessante, mas não limita a forma como o recurso é disponibilizado.
BROADENING Pode aumentar a cobertura além do normal.
AREA_OF_INTEREST_ONLY Restrito para todos os países de destino, mas pode veicular em outros países por área de interesse.

PolicyTopicEvidence

Informações adicionais que explicam a descoberta de uma política.

Representação JSON 
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
Campos
Campo de união value. Informações específicas das evidências, dependendo do tipo de evidência. value pode ser apenas de um dos tipos a seguir:
websiteList

object (WebsiteList)

Lista de sites vinculados a este recurso.
textList

object (TextList)

Lista de evidências encontradas no texto de um recurso.
languageCode

string

O idioma em que o recurso foi detectado como escrito. Essa é uma tag de idioma IETF, como "en-US".
destinationTextList

object (DestinationTextList)

O texto no destino do recurso que está causando uma descoberta de política.
destinationMismatch

object (DestinationMismatch)

Incompatibilidade entre os destinos dos URLs de um recurso.
destinationNotWorking

object (DestinationNotWorking)

Detalhes em que o destino retorna um código de erro HTTP ou não funciona em todos os locais dos dispositivos usados com frequência.

WebsiteList

Uma lista de sites que causaram a descoberta de uma política. Usado para o tópico de política ONE_WEBSITE_PER_AD_GROUP, por exemplo. Caso haja mais de cinco sites, apenas os cinco principais (aqueles que mais aparecem nos recursos) serão listados aqui.

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

string

Sites que causaram a descoberta da política.

TextList

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

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

string

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

DestinationTextList

Uma lista de strings encontradas em uma página de destino que causou uma descoberta de política.

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

string

Lista de texto encontrado na página de destino do recurso.

DestinationMismatch

Evidência de incompatibilidade entre os URLs de um recurso.

Representação JSON 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Campos
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

O conjunto de URLs que não corresponderam entre si.

PolicyTopicEvidenceDestinationMismatchUrlType

Os possíveis tipos de URL que não correspondem às evidências do tópico da política.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
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 modelo de URL de rastreamento, com o URL para computador substituído.
MOBILE_TRACKING_URL O modelo de URL de rastreamento, com URL para dispositivos móveis substituído.

DestinationNotWorking

São detalhes das evidências quando o destino retorna um código de erro HTTP ou não funciona em todos os locais dos dispositivos usados com frequência.

Representação JSON 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

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

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

O tipo de dispositivo que falhou ao carregar o URL.
expandedUrl

string

O URL completo que não funcionou.
lastCheckedDateTime

string

A hora em que o URL foi verificado pela última vez. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
Campo de união reason. Indica o motivo da descoberta da política de DESTINATION_NOT_WORKING. reason pode ser apenas de um dos tipos a seguir:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

O tipo de erro de DNS.
httpErrorCode

string (int64 format)

O código do erro HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

O possível destino da evidência do tópico da política que não funciona com dispositivos.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
DESKTOP A página de destino não funciona em computadores.
ANDROID A página de destino não funciona no dispositivo Android.
IOS A página de destino não funciona em dispositivos iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

O possível destino da evidência do tópico da política que não funciona com tipos de erro de DNS.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
HOSTNAME_NOT_FOUND O nome do host não foi encontrado no DNS ao buscar a página de destino.
GOOGLE_CRAWLER_DNS_ISSUE Problema com o rastreador interno do Google ao se comunicar com o DNS. Esse erro não significa que a página de destino não funciona. O Google vai rastrear novamente a página de destino.

PolicyTopicConstraint

Descreve o efeito na veiculação que uma entrada de tópico da política terá.

Representação JSON 
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
Campos
Campo de união value. Informações específicas sobre a restrição. value pode ser apenas de um dos tipos a seguir:
countryConstraintList

object (CountryConstraintList)

Países em que o recurso não pode ser veiculado.
resellerConstraint

object (ResellerConstraint)

Restrição para revendedores.
certificateMissingInCountryList

object (CountryConstraintList)

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

object (CountryConstraintList)

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

CountryConstraintList

Uma lista de países onde a veiculação de um recurso é restrita.

Representação JSON 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
Campos
countries[]

object (CountryConstraint)

Países em que a veiculação é restrita.
totalTargetedCountries

integer

Número total de países segmentados pelo recurso.

CountryConstraint

Indica que a capacidade de um recurso de ser veiculada em um país específico é limitada.

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

string

Nome do recurso constante da segmentação geográfica do país em que a veiculação está restrita.

ResellerConstraint

Esse tipo não tem campos.

Indica que um tópico da política foi restringido devido à reprovação do site para fins de revenda.

PolicyReviewStatus

Os possíveis status da análise de compliance com a política.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
REVIEW_IN_PROGRESS Em revisão no momento.
REVIEWED Revisão principal concluída. Outras análises podem continuar.
UNDER_APPEAL O recurso foi reenviado para aprovação ou a decisão relacionada à política foi contestada.
ELIGIBLE_MAY_SERVE O recurso está qualificado e pode estar sendo veiculado, mas ainda pode passar por uma análise mais detalhada.

PolicyApprovalStatus

Os possíveis status de aprovação da política. Quando houver vários status de aprovação disponíveis, o mais grave será usado. A ordem de gravidade é DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED e APPROVED.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
DISAPPROVED Não será veiculado.
APPROVED_LIMITED Funciona com restrições.
APPROVED Veicula sem restrições.
AREA_OF_INTEREST_ONLY Não será veiculado nos países de destino, mas poderá servir para usuários que estão pesquisando informações sobre esses países.

ResponsiveSearchAdInfo

Um anúncio responsivo de pesquisa.

Com os anúncios responsivos de pesquisa, você pode criar um anúncio que se adapta para mostrar mais texto e mensagens mais relevantes aos seus clientes. Se você incluir vários títulos e descrições ao criar o anúncio, com o tempo, o Google Ads vai testar automaticamente diferentes combinações e vai aprender quais apresentam melhor performance. Quando você adapta o conteúdo do seu anúncio para que ele corresponda melhor aos termos de pesquisa dos clientes em potencial, os anúncios responsivos de pesquisa podem melhorar a performance da campanha.

Mais informações em https://support.google.com/google-ads/answer/7684791

Representação JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista.
path1

string

Primeira parte do texto que pode ser anexada ao URL no anúncio.
path2

string

Segunda parte do texto que pode ser anexada ao URL no anúncio. Só é possível definir este campo quando path1 também está definido.

LegacyResponsiveDisplayAdInfo

Um anúncio responsivo de display legado Os anúncios desse tipo são rotulados como "Anúncios responsivos" na interface do Google Ads.

Representação JSON 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Campos
formatSetting

enum (DisplayAdFormatSetting)

Especifica em qual formato o anúncio será veiculado. O padrão é ALL_FORMATS.
shortHeadline

string

É a versão curta do título do anúncio.
longHeadline

string

É a versão longa do título do anúncio.
description

string

Descrição do anúncio.
businessName

string

Nome da empresa no anúncio.
allowFlexibleColor

boolean

Consentimento do anunciante para permitir cores flexíveis. Quando verdadeiro, o anúncio pode ser veiculado com uma cor diferente, se necessário. Quando for falso, o anúncio será veiculado com as cores especificadas ou neutras. O valor padrão é true. Precisa ser verdadeiro se mainColor e accentColor não estiverem definidos.
accentColor

string

A cor de destaque do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se mainColor ou accentColor for definido, o outro também será obrigatório.
mainColor

string

A cor principal do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se mainColor ou accentColor for definido, o outro também será obrigatório.
callToActionText

string

O texto da call-to-action do anúncio.
logoImage

string

O nome do recurso MediaFile da imagem do logotipo usada no anúncio.
squareLogoImage

string

O nome do recurso do MediaFile da imagem do logotipo quadrada usada no anúncio.
marketingImage

string

O nome do recurso MediaFile da imagem de marketing usada no anúncio.
squareMarketingImage

string

O nome do recurso MediaFile da imagem de marketing quadrada usada no anúncio.
pricePrefix

string

Prefixo antes do preço. Por exemplo, "tão baixo quanto".
promoText

string

Texto da promoção usado para formatos dinâmicos dos anúncios responsivos. Por exemplo, "Envio em dois dias com frete grátis".

DisplayAdFormatSetting

Enumera as configurações de formato do anúncio gráfico.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
ALL_FORMATS Texto, imagem e formatos nativos.
NON_NATIVE Formatos de texto e imagem.
NATIVE O formato nativo, por exemplo, é controlado pelo editor, e não pelo Google.

AppAdInfo

Um anúncio de app.

Representação JSON 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
Campos
mandatoryAdText

object (AdTextAsset)

Texto do anúncio obrigatório.
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista.
images[]

object (AdImageAsset)

Lista de recursos de imagem que podem ser exibidos com o anúncio.
youtubeVideos[]

object (AdVideoAsset)

Lista de recursos de vídeo do YouTube que podem ser exibidos com o anúncio.
html5MediaBundles[]

object (AdMediaBundleAsset)

Lista de recursos do pacote de mídia que podem ser usados com o anúncio.

AdMediaBundleAsset

Um recurso de pacote de mídia usado em um anúncio.

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

string

O nome do recurso do recurso deste pacote de mídia.

LegacyAppInstallAdInfo

Um anúncio de instalação de apps legado que só pode ser usado por alguns clientes selecionados.

Representação JSON 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Campos
appStore

enum (LegacyAppInstallAdAppStore)

A app store em que o app para dispositivos móveis está disponível.
appId

string

O ID do app para dispositivos móveis.
headline

string

Título do anúncio.
description1

string

A primeira linha de descrição do anúncio.
description2

string

A segunda linha de descrição do anúncio.

LegacyAppInstallAdAppStore

Tipo de app store em um anúncio de instalação de apps legado.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
APPLE_APP_STORE iTunes da Apple.
GOOGLE_PLAY Google Play
WINDOWS_STORE Loja do Windows.
WINDOWS_PHONE_STORE Loja do Windows Phone.
CN_APP_STORE O aplicativo está hospedado em uma loja de aplicativos chinesa.

ResponsiveDisplayAdInfo

Um anúncio responsivo de display

Representação JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Campos
marketingImages[]

object (AdImageAsset)

Imagens de marketing a serem usadas no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 600 x 314, e a proporção precisa ser 1,91:1 (+-1%). É necessário incluir pelo menos um marketingImage. Combinado com squareMarketingImages, o máximo é 15.
squareMarketingImages[]

object (AdImageAsset)

São imagens de marketing quadradas que serão usadas no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 300 x 300, e a proporção precisa ser 1:1 (+-1%). É necessário pelo menos um marketingImage quadrado. Combinado com marketingImages, o máximo é 15.
logoImages[]

object (AdImageAsset)

São as imagens de logotipo a serem usadas no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 512 x 128, e a proporção precisa ser 4:1 (+-1%). Combinado com squareLogoImages, o máximo é 5.
squareLogoImages[]

object (AdImageAsset)

São imagens quadradas do logotipo a serem usadas no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 128 x 128, e a proporção precisa ser 1:1 (+-1%). Combinado com logoImages, o máximo é 5.
headlines[]

object (AdTextAsset)

São os títulos de formato curto do anúncio. O comprimento máximo é de 30 caracteres. É possível especificar pelo menos um e no máximo cinco títulos.
longHeadline

object (AdTextAsset)

É um título de formato longo obrigatório. O comprimento máximo é de 90 caracteres.
descriptions[]

object (AdTextAsset)

Textos descritivos para o anúncio. O comprimento máximo é de 90 caracteres. É possível especificar pelo menos um e no máximo cinco títulos.
youtubeVideos[]

object (AdVideoAsset)

Vídeos opcionais do YouTube para o anúncio. É possível especificar no máximo cinco vídeos.
formatSetting

enum (DisplayAdFormatSetting)

Especifica em qual formato o anúncio será veiculado. O padrão é ALL_FORMATS.
controlSpec

object (ResponsiveDisplayAdControlSpec)

Especificação para vários controles de criativos.
businessName

string

Nome do anunciante/marca. A largura máxima de exibição é 25.
mainColor

string

A cor principal do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se mainColor ou accentColor for definido, o outro também será obrigatório.
accentColor

string

A cor de destaque do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se mainColor ou accentColor for definido, o outro também será obrigatório.
allowFlexibleColor

boolean

Consentimento do anunciante para permitir cores flexíveis. Quando verdadeiro, o anúncio pode ser veiculado com uma cor diferente, se necessário. Quando for falso, o anúncio será veiculado com as cores especificadas ou neutras. O valor padrão é true. Precisa ser verdadeiro se mainColor e accentColor não estiverem definidos.
callToActionText

string

O texto da call-to-action do anúncio. A largura máxima de exibição é 30.
pricePrefix

string

Prefixo antes do preço. Por exemplo, "tão baixo quanto".
promoText

string

Texto da promoção usado para formatos dinâmicos dos anúncios responsivos. Por exemplo, "Envio em dois dias com frete grátis".

ResponsiveDisplayAdControlSpec

Especificação para vários controles de criativo para um anúncio responsivo de display.

Representação JSON 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Campos
enableAssetEnhancements

boolean

Indica se o anunciante ativou o recurso de melhorias de recurso.
enableAutogenVideo

boolean

Indica se o anunciante ativou o recurso de vídeo de geração automática.

LocalAdInfo

Um anúncio local

Representação JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. É preciso especificar pelo menos um e no máximo cinco títulos.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista. É preciso especificar pelo menos uma e no máximo cinco descrições.
callToActions[]

object (AdTextAsset)

Lista de recursos de texto para calls-to-action. Quando o anúncio for veiculado, as calls-to-action serão selecionadas nessa lista. É necessário especificar pelo menos uma e no máximo cinco calls-to-action.
marketingImages[]

object (AdImageAsset)

Lista de recursos de imagem de marketing que podem ser mostrados com o anúncio. As imagens precisam ter 314 x 600 pixels ou 320 x 320 pixels. É preciso especificar no mínimo 1 e no máximo 20 recursos de imagem.
logoImages[]

object (AdImageAsset)

Lista de recursos de imagem do logotipo que podem ser mostrados com o anúncio. As imagens precisam ter 128 x 128 pixels e até 120 KB. É preciso especificar pelo menos um e no máximo cinco recursos de imagem.
videos[]

object (AdVideoAsset)

Lista de recursos de vídeo do YouTube que podem ser exibidos com o anúncio. É preciso especificar no mínimo 1 e no máximo 20 recursos de vídeo.
path1

string

Primeira parte do texto opcional que pode ser anexado ao URL no anúncio.
path2

string

Segunda parte do texto opcional que pode ser anexado ao URL no anúncio. Só é possível definir este campo quando path1 também está definido.

DisplayUploadAdInfo

Um tipo genérico de anúncio de display. O formato exato do anúncio é controlado pelo campo displayUploadProductType, que determina os tipos de dados que precisam ser incluídos.

Representação JSON 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Campos
displayUploadProductType

enum (DisplayUploadProductType)

O tipo de produto deste anúncio. Veja os comentários sobre a enumeração para saber mais detalhes.
Campo de união media_asset. Os dados do recurso que compõe o anúncio. media_asset pode ser apenas de um dos tipos a seguir:
mediaBundle

object (AdMediaBundleAsset)

Um recurso de pacote de mídia a ser usado no anúncio. Para informações sobre o pacote de mídia para HTML5_UPLOAD_AD, consulte https://support.google.com/google-ads/answer/1722096. Pacotes de mídia que fazem parte de tipos de produto dinâmicos usam um formato especial que precisa ser criado pelo Google Web Designer. Para mais informações, acesse https://support.google.com/webdesigner/answer/7543898.

DisplayUploadProductType

Enumera os tipos de produto de upload de display.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
HTML5_UPLOAD_AD Anúncio de upload HTML5. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido.
DYNAMIC_HTML5_EDUCATION_AD Anúncio de educação HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de educação.
DYNAMIC_HTML5_FLIGHT_AD Anúncio de voo HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de veiculação em flights.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Anúncio de aluguel e hotel HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só podem ser usadas em uma campanha de hotel.
DYNAMIC_HTML5_JOB_AD Anúncio de emprego HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usada em uma campanha de emprego.
DYNAMIC_HTML5_LOCAL_AD Anúncio local HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só podem ser usados em uma campanha local.
DYNAMIC_HTML5_REAL_ESTATE_AD Anúncio de imóveis HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha imobiliária.
DYNAMIC_HTML5_CUSTOM_AD Anúncio personalizado HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só podem ser usados em uma campanha personalizada.
DYNAMIC_HTML5_TRAVEL_AD Anúncio de viagem HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de viagens.
DYNAMIC_HTML5_HOTEL_AD Anúncio de hotel HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só podem ser usadas em uma campanha de hotel.

AppEngagementAdInfo

Com os anúncios de engajamento no app, você pode escrever um texto incentivando uma ação específica no aplicativo, como fazer check-in, realizar uma compra ou reservar um voo. Com elas, você pode direcionar os usuários para uma parte específica do aplicativo onde eles podem encontrar o que estão procurando com mais facilidade e rapidez.

Representação JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista.
images[]

object (AdImageAsset)

Lista de recursos de imagem que podem ser exibidos com o anúncio.
videos[]

object (AdVideoAsset)

Lista de recursos de vídeo que podem ser exibidos com o anúncio.

ShoppingComparisonListingAdInfo

Um anúncio de comparadores do Shopping.

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

string

Título do anúncio. Este campo é obrigatório. O tamanho permitido é de 25 a 45 caracteres.

SmartCampaignAdInfo

Um anúncio de campanha inteligente

Representação JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto, cada um deles correspondente a um título quando o anúncio é veiculado. Essa lista consiste em no mínimo 3 e no máximo 15 recursos de texto.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto, cada um deles correspondente a uma descrição quando o anúncio é veiculado. Essa lista consiste em no mínimo dois e no máximo quatro recursos de texto.

AppPreRegistrationAdInfo

Os anúncios de pré-registro do app são vinculados aos detalhes do app ou jogo no Google Play e podem ser exibidos no Google Play, no YouTube (somente in-stream) e em outros apps e sites para dispositivos móveis na Rede de Display. Isso ajuda a capturar o interesse das pessoas no seu app ou jogo e a gerar uma base instalada antecipada antes do lançamento.

Representação JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista.
images[]

object (AdImageAsset)

Lista de códigos de recursos de imagem cujas imagens podem ser exibidas com o anúncio.
youtubeVideos[]

object (AdVideoAsset)

Lista de IDs de recursos de vídeo do YouTube cujos vídeos podem ser exibidos com o anúncio.

DiscoveryMultiAssetAdInfo

Um anúncio Discovery com vários recursos.

Representação JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Campos
marketingImages[]

object (AdImageAsset)

Recursos de imagem de marketing a serem usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 600 x 314, e a proporção precisa ser 1,91:1 (+-1%). Obrigatório se SquareMarketingImages não estiver presente. Combinado com squareMarketingImages e portraitMarketingImages, o máximo é 20.
squareMarketingImages[]

object (AdImageAsset)

Recursos de imagem de marketing quadradas que serão usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 300 x 300, e a proporção precisa ser 1:1 (+-1%). Obrigatório se marketingImages não estiver presente. Combinado com marketingImages e portraitMarketingImages, o máximo é 20.
portraitMarketingImages[]

object (AdImageAsset)

Recursos de imagem de marketing em modo retrato a serem usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é de 480 x 600, e a proporção precisa ser de 4:5 (+-1%). Combinado com marketingImages e squareMarketingImages, o máximo é 20.
logoImages[]

object (AdImageAsset)

Recursos de imagem do logotipo a serem usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 128 x 128, e a proporção precisa ser 1:1 (+-1%). É possível especificar no mínimo uma e no máximo cinco imagens de logotipo.
headlines[]

object (AdTextAsset)

Recurso de texto do título do anúncio. A largura máxima de exibição é 30. É possível especificar pelo menos um e no máximo cinco títulos.
descriptions[]

object (AdTextAsset)

O texto descritivo do anúncio. A largura máxima é 90. É possível especificar de uma a cinco descrições.
businessName

string

O nome do anunciante/marca. A largura máxima de exibição é 25. Obrigatório.
callToActionText

string

Texto de call-to-action.
leadFormOnly

boolean

Opção booleana que indica se o anúncio precisa ser veiculado com o formulário de lead.

DiscoveryCarouselAdInfo

Um anúncio Discovery de carrossel.

Representação JSON 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
Campos
businessName

string

Obrigatório. O nome do anunciante/marca.
logoImage

object (AdImageAsset)

Obrigatório. A imagem do logotipo será usada no anúncio. O tamanho mínimo é 128 x 128, e a proporção precisa ser 1:1 (+-1%).
headline

object (AdTextAsset)

Obrigatório. Título do anúncio.
description

object (AdTextAsset)

Obrigatório. O texto descritivo do anúncio.
callToActionText

string

Texto de call-to-action.
carouselCards[]

object (AdDiscoveryCarouselCardAsset)

Obrigatório. Cards de carrossel que vão ser exibidos com o anúncio Mín. 2 máx. 10.

AdDiscoveryCarouselCardAsset

Um recurso Discovery de carrossel usado em um anúncio.

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

string

O nome do recurso de recurso deste card de descoberta do carrossel.

DiscoveryVideoResponsiveAdInfo

Um anúncio responsivo em vídeo Discovery.

Representação JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto usados no título curto.
longHeadlines[]

object (AdTextAsset)

Lista de recursos de texto usados no título longo.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto usados na descrição.
videos[]

object (AdVideoAsset)

A lista dos recursos de vídeo do YouTube usados para o anúncio.
logoImages[]

object (AdImageAsset)

A imagem do logotipo será usada no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 128 x 128, e a proporção precisa ser 1:1 (+-1%).
breadcrumb1

string

Primeira parte do texto que aparece no anúncio com o URL exibido.
breadcrumb2

string

Segunda parte do texto que aparece no anúncio com o URL exibido.
businessName

object (AdTextAsset)

Obrigatório. Nome do anunciante/marca.
callToActions[]

object (AdCallToActionAsset)

Recursos do tipo CallToActionAsset usados no botão "Call-to-action".

AdCallToActionAsset

É um recurso de call-to-action usado em um anúncio.

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

string

O nome do recurso desse recurso de call-to-action.

TravelAdInfo

Esse tipo não tem campos.

Um anúncio de viagens.

Métodos

get

 Retorna o anúncio solicitado com todos os detalhes.

mutate

 Atualiza anúncios.