Ad

Anúncio

Representação JSON 
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
Campos
resourceName

string

Imutável. O nome de recurso do anúncio. Os nomes de recursos de anúncio têm o seguinte formato:

customers/{customerId}/ads/{ad_id}
finalUrls[]

string

A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio.
finalAppUrls[]

object (FinalAppUrl)

É uma lista de URLs finais do aplicativo que serão usados em dispositivos móveis se o usuário tiver o aplicativo específico instalado.
finalMobileUrls[]

string

A lista dos possíveis URLs finais para dispositivos móveis após todos os redirecionamentos de vários domínios do anúncio.
urlCustomParameters[]

object (CustomParameter)

Lista de mapeamentos que podem ser usados para substituir tags de parâmetros personalizados em um trackingUrlTemplate, finalUrls ou mobile_final_urls. Para mutates, use operações de parâmetro personalizado do URL.
type

enum (AdType)

Apenas saída. O tipo de anúncio.
devicePreference

enum (Device)

A preferência de dispositivo para o anúncio. Só é possível especificar uma preferência para dispositivos móveis. Quando essa preferência é definida, o anúncio tem preferência sobre outros anúncios quando é exibido em um dispositivo móvel. O anúncio ainda poderá ser exibido em outros tipos de dispositivos, por exemplo, se nenhum outro anúncio estiver disponível. Se não for especificado (sem preferência de dispositivo), todos os dispositivos serão segmentados. Essa opção só é compatível com alguns tipos de anúncio.
urlCollections[]

object (UrlCollection)

URLs adicionais para o anúncio que são marcados com um identificador exclusivo que pode ser referenciado em outros campos no anúncio.
systemManagedResourceSource

enum (SystemManagedResourceSource)

Apenas saída. Se esse anúncio for gerenciado pelo sistema, este campo indicará a origem. Este campo é somente leitura.
id

string (int64 format)

Apenas saída. O ID do anúncio.
trackingUrlTemplate

string

O modelo de URL para criar um URL de rastreamento.
finalUrlSuffix

string

O sufixo a ser usado ao criar um URL final.
displayUrl

string

É o URL exibido na descrição de alguns formatos de anúncio.
addedByGoogleAds

boolean

Apenas saída. Indica se o anúncio foi adicionado automaticamente pelo Google Ads, e não por um usuário. Por exemplo, isso pode acontecer quando os anúncios são criados automaticamente como sugestões de novos anúncios com base no desempenho de anúncios existentes.
name

string

Imutável. É o nome do anúncio. Isso é usado apenas para identificar o anúncio. Ele não precisa ser único e não afeta o anúncio veiculado. No momento, o campo de nome só é compatível com DisplayUploadAd, ImageAd, ShoppingComparisonListingAd e VideoAd.
Campo de união ad_data. Detalhes pertinentes ao tipo de anúncio. Exatamente um valor precisa ser definido. ad_data só pode ser de um dos seguintes tipos:
textAd

object (TextAdInfo)

Imutável. Detalhes relacionados a um anúncio de texto.
expandedTextAd

object (ExpandedTextAdInfo)

Detalhes relacionados a anúncios de texto expandidos.
callAd

object (CallAdInfo)

Detalhes relacionados a um anúncio de chamada.
expandedDynamicSearchAd

object (ExpandedDynamicSearchAdInfo)

Imutável. Detalhes relacionados a um anúncio dinâmico expandido de pesquisa. Esse tipo de anúncio tem o título, os URLs finais e o URL de visualização gerados automaticamente no momento da veiculação de acordo com as informações específicas do nome de domínio fornecidas por dynamicSearchAdsSetting vinculadas no nível da campanha.
hotelAd

object (HotelAdInfo)

Detalhes relacionados a um anúncio de hotel.
shoppingSmartAd

object (ShoppingSmartAdInfo)

Detalhes relacionados a um anúncio inteligente do Shopping.
shoppingProductAd

object (ShoppingProductAdInfo)

Detalhes relacionados a um anúncio de produto do Shopping.
imageAd

object (ImageAdInfo)

Imutável. Detalhes relacionados a um anúncio gráfico.
videoAd

object (VideoAdInfo)

Detalhes relacionados a um anúncio em vídeo.
videoResponsiveAd

object (VideoResponsiveAdInfo)

Detalhes relacionados a um anúncio responsivo em vídeo.
responsiveSearchAd

object (ResponsiveSearchAdInfo)

Detalhes relacionados a um anúncio responsivo de pesquisa.
legacyResponsiveDisplayAd

object (LegacyResponsiveDisplayAdInfo)

Detalhes relacionados a um anúncio responsivo de display legado
appAd

object (AppAdInfo)

Detalhes relacionados a um anúncio de aplicativo.
legacyAppInstallAd

object (LegacyAppInstallAdInfo)

Imutável. Detalhes relacionados a um anúncio legado de instalação de apps.
responsiveDisplayAd

object (ResponsiveDisplayAdInfo)

Detalhes relacionados a um anúncio responsivo de display
localAd

object (LocalAdInfo)

Detalhes relacionados a um anúncio local.
displayUploadAd

object (DisplayUploadAdInfo)

Detalhes relacionados a um anúncio de upload de display.
appEngagementAd

object (AppEngagementAdInfo)

Detalhes relacionados a um anúncio de engajamento no app.
shoppingComparisonListingAd

object (ShoppingComparisonListingAdInfo)

São detalhes relacionados a um anúncio de comparação do Shopping.
smartCampaignAd

object (SmartCampaignAdInfo)

Detalhes relacionados a um anúncio de campanha inteligente.
appPreRegistrationAd

object (AppPreRegistrationAdInfo)

Detalhes relacionados a um anúncio de pré-registro de app.
demandGenMultiAssetAd

object (DemandGenMultiAssetAdInfo)

Detalhes relacionados a um anúncio com vários recursos da Geração de demanda.
demandGenVideoResponsiveAd

object (DemandGenVideoResponsiveAdInfo)

Detalhes relacionados a um anúncio responsivo em vídeo da Geração de demanda.
demandGenProductAd

object (DemandGenProductAdInfo)

Detalhes relacionados a um anúncio de produto da Geração de demanda.
travelAd

object (TravelAdInfo)

Detalhes relacionados a um anúncio de viagens.

FinalAppUrl

É um URL de link direto para um app em um determinado sistema operacional.

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

enum (AppUrlOperatingSystemType)

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

string

O 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. No seu app, você pode usar um esquema personalizado que comece com o nome dele. O host e o caminho especificam o local único no aplicativo onde seu conteúdo se encontra. Exemplo: "exampleapp://productid_1234". Obrigatório.

AppUrlOperatingSystemType

Sistema operacional

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

AdType

Os possíveis tipos de um anúncio.

Tipos enumerados
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor somente de resposta.
TEXT_AD O anúncio é de texto.
EXPANDED_TEXT_AD É um anúncio de texto expandido.
EXPANDED_DYNAMIC_SEARCH_AD É um anúncio dinâmico expandido de pesquisa.
HOTEL_AD É um anúncio de hotel.
SHOPPING_SMART_AD O anúncio é inteligente do Shopping.
SHOPPING_PRODUCT_AD O anúncio é padrão do Shopping.
VIDEO_AD O anúncio é em vídeo.
IMAGE_AD Este é um anúncio gráfico.
RESPONSIVE_SEARCH_AD O anúncio é responsivo de pesquisa.
LEGACY_RESPONSIVE_DISPLAY_AD É um anúncio responsivo de display legado.
APP_AD É um anúncio de app.
LEGACY_APP_INSTALL_AD É um anúncio legado de instalação de apps.
RESPONSIVE_DISPLAY_AD O anúncio é responsivo de display.
LOCAL_AD O anúncio é local.
HTML5_UPLOAD_AD O anúncio é de upload de display com o tipo de produto HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD O anúncio é de upload de display com um dos tipos de produto DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD O anúncio é de engajamento no app.
SHOPPING_COMPARISON_LISTING_AD É um anúncio de comparação 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 em vídeo TrueView in-stream.
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 Anúncio de pré-registro universal para apps.
IN_FEED_VIDEO_AD Anúncio em vídeo In-feed.
DEMAND_GEN_MULTI_ASSET_AD Anúncio com vários recursos da Geração de demanda.
TRAVEL_AD Anúncio de viagens.
DEMAND_GEN_VIDEO_RESPONSIVE_AD Anúncio responsivo em vídeo da Geração de demanda.
DEMAND_GEN_PRODUCT_AD Anúncio de produtos da Geração de demanda.

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 para esta instância 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.

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

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

Um 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

Um 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 do anúncio.
headline2

string

Segundo título no 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

Indica se o acompanhamento de chamadas será ativado para o criativo. A ativação do acompanhamento de chamadas também ativa as conversões de chamada.
disableCallConversion

boolean

Define se a conversão de chamada será desativada para o criativo. 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 verificação do número de telefone.
conversionAction

string

A ação de conversão a que uma conversão de chamada será atribuída. Se ele não for definido, uma ação de conversão padrão será usada. Esse campo só terá efeito se callTracked for definido como true. Caso contrário, este campo será ignorado.
conversionReportingState

enum (CallConversionReportingState)

O comportamento de conversão de chamada deste 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 do anúncio. Opcional.
path2

string

Segunda parte do texto que pode ser anexada ao URL do anúncio. Esse campo só pode ser definido quando path1 também está definido. Opcional.

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:
  "imageAsset": {
    object (AdImageAsset)
  },
  "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 do tamanho da visualização.
previewPixelHeight

string (int64 format)

Altura em pixels da imagem do 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 deve ser criado. Isso pode ser especificado de duas maneiras. 1. Um recurso MediaFile existente. 2. Dados de imagem brutos como bytes. image só pode ser de um dos seguintes tipos:
imageAsset

object (AdImageAsset)

Os recursos de imagem usados para o anúncio.
data

string (bytes format)

Dados brutos de imagem como bytes.

Uma string codificada em base64.
adIdToCopyImageFrom

string (int64 format)

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

AdImageAsset

Um recurso de imagem usado em um anúncio.

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

string

O nome do recurso do recurso dessa imagem.

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 no anúncio.
Campo de união format. Esquema específico para os diferentes formatos de vídeo. format só pode ser de um dos seguintes tipos:
inStream

object (VideoTrueViewInStreamAdInfo)

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

object (VideoBumperInStreamAdInfo)

Formato de anúncio in-stream em vídeo bumper.
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 dentro de um anúncio.

Representação JSON 
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
Campos
asset

string

O nome do recurso do recurso deste vídeo.
adVideoAssetInfo

object (AdVideoAssetInfo)

Contém campos de informação para este AdVideoAsset.

AdVideoAssetInfo

Contém campos de informação para AdVideoAssets.

Representação JSON 
{
  "adVideoAssetInventoryPreferences": {
    object (AdVideoAssetInventoryPreferences)
  }
}
Campos
adVideoAssetInventoryPreferences

object (AdVideoAssetInventoryPreferences)

Lista de preferências de inventário para este AdVideoAsset. Esse campo só pode ser definido para DiscoveryVideoResponsiveAd. Os recursos de vídeo com uma preferência de recurso de inventário definida terão preferência em relação a outros vídeos do mesmo anúncio durante o período de veiculação. Por exemplo, considere que esse anúncio está sendo veiculado para um inventário específico. Primeiro, o servidor tentará combinar um vídeo qualificado com uma preferência correspondente para esse inventário. Os vídeos sem preferências são escolhidos apenas quando um vídeo com preferência correspondente e qualificado para um determinado espaço do anúncio pode ser encontrado.

AdVideoAssetInventoryPreferences

Preferências de inventário de recursos de vídeo do YouTube. Próxima tag: 4

Representação JSON 
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
Campos
inFeedPreference

boolean

Quando verdadeiro, o recurso de vídeo do YouTube com essa preferência de inventário terá preferência ao escolher um vídeo para veicular no feed.
inStreamPreference

boolean

Quando definido como verdadeiro, o recurso de vídeo do YouTube com essa preferência de inventário terá preferência ao escolher um vídeo para veicular in-stream.
shortsPreference

boolean

Quando definido como verdadeiro, o recurso de vídeo do YouTube com essa preferência de inventário terá preferência ao escolher um vídeo para veicular no YouTube Shorts.

VideoTrueViewInStreamAdInfo

Representação do formato de anúncio TrueView in-stream em vídeo (anúncio exibido durante a reprodução do vídeo, geralmente no início, com 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 os cliques no botão.
companionBanner

object (AdImageAsset)

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

VideoBumperInStreamAdInfo

Representação do formato de anúncio in-stream bumper em vídeo (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 do 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 os cliques no botão.

VideoOutstreamAdInfo

Representação do formato de 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 in-stream não pulável em vídeo (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 do 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 cliques no botão.

InFeedVideoAdInfo

Representação do formato de 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 possíveis tipos de miniaturas de vídeos.

Tipos enumerados
UNSPECIFIED O tipo não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta.
DEFAULT_THUMBNAIL A miniatura padrão. Pode ser gerado automaticamente ou enviado 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, só é possível usar um valor para o título curto.
longHeadlines[]

object (AdTextAsset)

Lista de recursos de texto usados no título longo. No momento, só é possível usar um único valor para o título longo.
descriptions[]

object (AdTextAsset)

Lista de recursos de texto usados para a descrição. No momento, só é possível usar um valor para a descrição.
callToActions[]

object (AdTextAsset)

Lista de recursos de texto usados para o botão, como o botão "Call-to-action". Atualmente, há suporte para apenas um valor para o botão.
videos[]

object (AdVideoAsset)

A lista dos recursos de vídeo do YouTube usados no anúncio. No momento, só é possível usar um valor para o recurso de vídeo do YouTube.
companionBanners[]

object (AdImageAsset)

Lista de recursos de imagem usados para o banner complementar. Atualmente, apenas 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.

ResponsiveSearchAdInfo

Um anúncio responsivo de pesquisa.

Com os anúncios responsivos de pesquisa, você pode criar um anúncio que se ajusta para exibir 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 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 do anúncio.
path2

string

Segunda parte do texto que pode ser anexada ao URL do anúncio. Esse campo só pode ser definido 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 forem definidos, 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 forem definidos, 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 de display.

Tipos enumerados
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 Formato nativo, por exemplo, a renderização do formato é controlada pelo editor, e não pelo Google.

AppAdInfo

Um anúncio de aplicativo.

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)

O 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 legado de instalação de apps 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 aplicativo 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

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

string

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

LegacyAppInstallAdAppStore

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

Tipos enumerados
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 app está hospedado em uma app store 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 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 forem definidos, 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 forem definidos, 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 criativos 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 recursos.
enableAutogenVideo

boolean

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

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. É necessário especificar de um a 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. É necessário especificar de uma a cinco descrições.
callToActions[]

object (AdTextAsset)

Lista de recursos de texto para calls-to-action. Quando o anúncio veicular, as call-to-actions serão selecionadas nesta 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. É necessário especificar de 1 a 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 não podem ser maiores que 120 KB. É necessário especificar de um a cinco recursos de imagem.
videos[]

object (AdVideoAsset)

Lista de recursos de vídeo do YouTube que podem ser exibidos com o anúncio. Especifique pelo menos um 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 anexada ao URL no anúncio. Esse campo só pode ser definido quando path1 também está definido.

DisplayUploadAdInfo

Um tipo genérico de anúncio gráfico. O formato exato do anúncio é controlado pelo campo displayUploadProductType, que determina quais tipos de dados precisam ser incluídos com o anúncio.

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. Confira os comentários sobre o tipo enumerado para mais detalhes.
Campo de união media_asset. Os dados do recurso que compõem o anúncio. media_asset só pode ser de um dos seguintes tipos:
mediaBundle

object (AdMediaBundleAsset)

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

DisplayUploadProductType

Enumera os tipos de produtos de upload de display.

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

AppEngagementAdInfo

Com os anúncios de engajamento no app, você pode escrever textos incentivando uma ação específica no aplicativo, como fazer check-in, realizar uma compra ou reservar um voo. Eles permitem direcionar os usuários a uma parte específica do seu app onde eles podem encontrar o que procuram de maneira mais fácil e rápida.

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)

É a lista de recursos de vídeo que podem ser exibidos com o anúncio.

ShoppingComparisonListingAdInfo

Um anúncio de comparação 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.

AppPreRegistrationAdInfo

Os anúncios de pré-registro do app são vinculados à página "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 da Rede de Display. Isso ajuda a despertar 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)

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

object (AdVideoAsset)

É a lista de IDs de recursos de vídeo do YouTube em que os vídeos podem ser exibidos com o anúncio.

DemandGenMultiAssetAdInfo

Um anúncio com vários recursos da Geração de demanda.

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 quadrados a serem 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 imagens de marketing no modo retrato que serão usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 480 x 600, e a proporção precisa ser 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 de 1 a 5 imagens de logotipo.
headlines[]

object (AdTextAsset)

Recurso de texto de 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 de exibição é 90. É possível especificar de 1 a 5 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 um formulário de lead.

DemandGenCarouselAdInfo

Um anúncio de carrossel da Geração de demanda.

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

string

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

object (AdImageAsset)

Obrigatório. A imagem do logotipo a 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 (AdDemandGenCarouselCardAsset)

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

AdDemandGenCarouselCardAsset

Um recurso de card de carrossel da Geração de demanda usado em um anúncio.

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

string

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

DemandGenVideoResponsiveAdInfo

Um anúncio responsivo em vídeo da Geração de demanda.

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 para a descrição.
videos[]

object (AdVideoAsset)

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

object (AdImageAsset)

A imagem do logotipo a 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 para o 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 deste recurso de call-to-action.

DemandGenProductAdInfo

Um anúncio de produto da Geração de demanda.

Representação JSON 
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
Campos
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.
headline

object (AdTextAsset)

Obrigatório. Recurso de texto usado para o título curto.
description

object (AdTextAsset)

Obrigatório. Recurso de texto usado para a descrição.
logoImage

object (AdImageAsset)

Obrigatório. A imagem do logotipo a 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%).
callToAction

object (AdCallToActionAsset)

Recurso do tipo CallToActionAsset usado para o botão "Call-to-action".

TravelAdInfo

Esse tipo não tem campos.

Um anúncio de viagens.