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 do recurso do anúncio. Os nomes dos recursos de anúncios 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)

A lista de mapeamentos que podem ser usados para substituir tags de parâmetros personalizados em um trackingUrlTemplate, finalUrls ou mobile_final_urls. Para mutações, 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 dispositivo, por exemplo, se não houver outros anúncios disponíveis. 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)

Outros URLs do anúncio que são marcados com um identificador exclusivo que pode ser referenciado em outros campos do 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. É necessário definir exatamente um valor. ad_data pode ser apenas de um dos tipos a seguir:
textAd

object (TextAdInfo)

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

object (ExpandedTextAdInfo)

Detalhes relacionados a um anúncio de texto expandido.
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 vinculado 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 app.
legacyAppInstallAd

object (LegacyAppInstallAdInfo)

Imutável. Detalhes relacionados a um anúncio de instalação de app legada.
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)

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 de 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 para links diretos em um app para o sistema operacional especificado.

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 app. 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 o app, você pode usar um esquema personalizado que começa com o nome dele. O host e o caminho especificam o local exclusivo no app em que o conteúdo existe. Exemplo: "exampleapp://productid_1234". Obrigatório.

AppUrlOperatingSystemType

Sistema operacional

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 anúncio.

Enums
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 O anúncio é de texto expandido.
EXPANDED_DYNAMIC_SEARCH_AD O anúncio é um anúncio dinâmico expandido de pesquisa.
HOTEL_AD O anúncio é de hotel.
SHOPPING_SMART_AD O anúncio é inteligente do Shopping.
SHOPPING_PRODUCT_AD O anúncio é um anúncio padrão do Shopping.
VIDEO_AD O anúncio é em vídeo.
IMAGE_AD Este anúncio é de imagem.
RESPONSIVE_SEARCH_AD O anúncio é um anúncio responsivo de pesquisa.
LEGACY_RESPONSIVE_DISPLAY_AD O anúncio é um anúncio responsivo de display legado.
APP_AD O anúncio é um anúncio de app.
LEGACY_APP_INSTALL_AD O anúncio é 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 é um upload de display com o tipo de produto HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD O anúncio é um upload de exibição com um dos tipos de produto DYNAMIC_HTML5_*
APP_ENGAGEMENT_AD O anúncio é de engajamento no app.
SHOPPING_COMPARISON_LISTING_AD O anúncio é 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 in-stream não pulável em vídeo.
VIDEO_TRUEVIEW_IN_STREAM_AD Anúncio in-stream TrueView 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 Anúncio de pré-registro do app universal.
IN_FEED_VIDEO_AD Anúncio em vídeo In-feed.
DEMAND_GEN_MULTI_ASSET_AD Anúncio com vários recursos de Geração de demanda.
TRAVEL_AD Anúncio de viagem.
DEMAND_GEN_VIDEO_RESPONSIVE_AD Anúncio responsivo em vídeo da Geração de demanda.
DEMAND_GEN_PRODUCT_AD Anúncio de produto da Geração de demanda.

UrlCollection

Coleção de URLs 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 essa instância de UrlCollection.
trackingUrlTemplate

string

Modelo de URL para criar um URL de rastreamento.

SystemManagedResourceSource

Enum que lista as possíveis origens de entidades gerenciadas pelo sistema.

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

TextAdInfo

Um anúncio de texto.

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

string

O 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 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

Se o acompanhamento de chamadas está ativado para o criativo. Ativar o acompanhamento de chamadas também ativa as conversões de chamadas.
disableCallConversion

boolean

Indica se a conversão de chamada está desativada para o criativo. Se definido como true, desativa as conversões de chamada mesmo quando callTracked é true. Se callTracked for false, esse 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 a que uma conversão de chamada é atribuída. Se não for definido, uma ação de conversão padrão será usada. Esse 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ão 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. Este campo só pode ser definido quando path1 também é 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 da prévia.
previewImageUrl

string

URL da imagem no tamanho de 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 que será usada para criar o ImageAd. Isso pode ser especificado de duas maneiras. 1. Um recurso MediaFile existente. 2. Os dados da imagem bruta como bytes. image pode ser apenas de um dos tipos a seguir:
imageAsset

object (AdImageAsset)

Os recursos de imagem usados no anúncio.
data

string (bytes format)

Dados de imagem bruta como bytes.

Uma string codificada em base64.
adIdToCopyImageFrom

string (int64 format)

Um ID do anúncio para copiar a imagem.

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.

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 pode ser apenas de um dos tipos a seguir:
inStream

object (VideoTrueViewInStreamAdInfo)

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

object (VideoBumperInStreamAdInfo)

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

object (VideoOutstreamAdInfo)

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

object (VideoNonSkippableInStreamAdInfo)

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

object (InFeedVideoAdInfo)

Formato de anúncio em vídeo In-feed.

AdVideoAsset

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

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

string

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

object (AdVideoAssetInfo)

Contém campos de informações para esse AdVideoAsset.

AdVideoAssetInfo

Contém campos de informações para AdVideoAssets.

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

object (AdVideoAssetInventoryPreferences)

Lista de preferências de inventário para esse AdVideoAsset. Este campo só pode ser definido para DiscoveryVideoResponsiveAd. Os recursos de vídeo com uma preferência de recurso de inventário definida têm preferência sobre outros vídeos do mesmo anúncio durante o tempo de veiculação. Por exemplo, considere este anúncio veiculado para um inventário específico. Primeiro, o servidor vai tentar encontrar 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 de anúncio pode ser encontrado.

AdVideoAssetInventoryPreferences

Preferências de inventário de recursos de vídeo do YouTube.

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

boolean

Quando essa opção é definida como "true", o recurso de vídeo do YouTube com essa preferência de inventário é priorizado ao escolher um vídeo para exibição no feed.
inStreamPreference

boolean

Quando essa opção é definida como "true", o recurso de vídeo do YouTube com essa preferência de inventário será preferido ao escolher um vídeo para exibição no stream.
shortsPreference

boolean

Quando verdadeiro, o recurso de vídeo do YouTube com essa preferência de inventário será priorizado ao escolher um vídeo para exibição no YouTube Shorts.

VideoTrueViewInStreamAdInfo

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

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

string

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

string

Texto extra exibido com o botão de call-to-action (CTA) para dar contexto e incentivar os cliques.
companionBanner

object (AdImageAsset)

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

VideoBumperInStreamAdInfo

Representação do formato de anúncio in-stream bumper (anúncio 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 usado 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 extra exibido com o botão de call-to-action (CTA) para dar contexto e incentivar os cliques.

VideoOutstreamAdInfo

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

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

string

O 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 (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 usado 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 extra exibido com o botão "Call To Action" para dar contexto e incentivar os 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

O 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 de miniatura do vídeo a ser usada.

VideoThumbnail

Enum que lista os tipos possíveis de 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 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 para o título curto. No momento, apenas um valor para o título curto é aceito.
longHeadlines[]

object (AdTextAsset)

Lista de recursos de texto usados para o 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 na descrição. No momento, apenas um valor para a descrição é aceito.
callToActions[]

object (AdTextAsset)

Lista de recursos de texto usados para o botão, por exemplo, o botão "Call To Action". No momento, apenas um valor para o botão é aceito.
videos[]

object (AdVideoAsset)

Lista de recursos de vídeo do YouTube usados no anúncio. No momento, apenas um valor para o recurso de vídeo do YouTube é aceito.
companionBanners[]

object (AdImageAsset)

Lista de recursos de imagem usados no banner complementar. No momento, apenas um valor para o recurso de banner complementar é aceito.
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ê cria um anúncio que se ajusta para mostrar mais texto e mensagens mais relevantes aos seus clientes. Se você inserir vários títulos e descrições ao criar um anúncio desse tipo, com o tempo, o Google Ads testará automaticamente diferentes combinações e saberá quais apresentam melhor desempenho. Quando você adapta o conteúdo da publicidade aos termos de pesquisa dos clientes em potencial, os anúncios responsivos de pesquisa podem melhorar a performance da campanha.

Saiba mais 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. Este campo só pode ser definido quando path1 também é definido.

LegacyResponsiveDisplayAdInfo

Um anúncio responsivo de display legado. 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 uma das cores mainColor e accentColor estiver definida, a outra também será obrigatória.
mainColor

string

É a cor principal do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se uma das cores mainColor e accentColor estiver definida, a outra também será obrigatória.
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, "a partir de".
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 do formato do anúncio de display.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
ALL_FORMATS Texto, imagem e formatos nativos.
NON_NATIVE Formatos de texto e imagem.
NATIVE Formato nativo, por exemplo, a renderização de formato é controlada 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)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
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 do pacote de mídia usado em um anúncio.

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

string

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

AdAppDeepLinkAsset

Um link direto de app usado em um anúncio.

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

string

O nome do recurso do link direto do app.

LegacyAppInstallAdInfo

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

O título do anúncio.
description1

string

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

string

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

LegacyAppInstallAdAppStore

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
APPLE_APP_STORE iTunes da Apple.
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows Store.
WINDOWS_PHONE_STORE Windows Phone Store.
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 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 criativo.
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 uma das cores mainColor e accentColor estiver definida, a outra também será obrigatória.
accentColor

string

A cor de destaque do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se uma das cores mainColor e accentColor estiver definida, a outra também será obrigatória.
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, "a partir de".
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 de um anúncio responsivo de display.

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

boolean

Se o anunciante ativou o recurso de melhorias de recursos.
enableAutogenVideo

boolean

Se o anunciante ativou o recurso de geração automática de vídeos.

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 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. É necessário 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 chamadas para ação serão selecionadas nessa lista. É necessário especificar pelo menos 1 e no máximo 5 calls-to-action.
marketingImages[]

object (AdImageAsset)

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

object (AdImageAsset)

Lista de recursos de imagem do logotipo que podem ser exibidos com o anúncio. As imagens precisam ter 128 x 128 pixels e não podem ter mais de 120 KB. É preciso especificar pelo menos 1 e no máximo 5 recursos de imagem.
videos[]

object (AdVideoAsset)

Lista de recursos de vídeo do YouTube que podem ser exibidos com o anúncio. É necessário especificar pelo menos 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. Este campo só pode ser definido quando path1 também é definido.

DisplayUploadAdInfo

Um tipo genérico de anúncio de display. O formato exato do anúncio é controlado pelo campo displayUploadProductType, que determina quais tipos de dados precisam ser incluídos no 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 do anúncio. Consulte os comentários no tipo enumerado para saber mais detalhes.
Campo de união media_asset. Os dados do recurso que compõem o anúncio. media_asset pode ser apenas de um dos tipos a seguir:
mediaBundle

object (AdMediaBundleAsset)

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

DisplayUploadProductType

Enumera os tipos de produtos de upload de tela.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
HTML5_UPLOAD_AD Anúncio de upload HTML5. Esse tipo de produto exige que o campo upload_media_bundle em DisplayUploadAdInfo seja definido.
DYNAMIC_HTML5_EDUCATION_AD Anúncio de educação HTML5 dinâmico. Esse tipo de produto exige que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de conscientização.
DYNAMIC_HTML5_FLIGHT_AD Anúncio de voo HTML5 dinâmico. Esse tipo de produto exige que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de voo.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Anúncio dinâmico de hotéis e aluguéis HTML5. Esse tipo de produto exige 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 exige que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de vagas de emprego.
DYNAMIC_HTML5_LOCAL_AD Anúncio local HTML5 dinâmico. Esse tipo de produto exige 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 exige 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. Esse tipo de produto exige 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 viagem HTML5 dinâmico. Esse tipo de produto exige 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. Esse tipo de produto exige 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 que incentivam uma ação específica no seu aplicativo, como fazer check-in, realizar uma compra ou reservar um voo. Além disso, eles possibilitam enviar os usuários a uma parte específica do seu aplicativo onde podem encontrar o que estão procurando com mais facilidade e rapidez do que na Web.

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 comparação do Shopping.

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

string

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

AppPreRegistrationAdInfo

Os anúncios de pré-registro de apps são vinculados à página de detalhes do seu app ou jogo no Google Play e podem ser veiculados no Google Play, no YouTube (somente in-stream) e em outros apps e sites para dispositivos móveis na Rede de Display. Isso vai ajudar a despertar o interesse das pessoas no seu app ou jogo e gerar uma base instalada 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 IDs de recursos de imagem que podem ser exibidos com o anúncio.
youtubeVideos[]

object (AdVideoAsset)

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

DemandGenMultiAssetAdInfo

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

Representação JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      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. Em combinação com squareMarketingImages, portraitMarketingImages e tallPortraitMarketingImages, o máximo é 20.
squareMarketingImages[]

object (AdImageAsset)

Recursos de imagem de marketing quadrados 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. Em combinação com marketingImages, portraitMarketingImages e tallPortraitMarketingImages, 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 é 480 x 600, e a proporção precisa ser 4:5 (+-1%). Em combinação com marketingImages, squareMarketingImages e tallPortraitMarketingImages, o máximo é 20.
tallPortraitMarketingImages[]

object (AdImageAsset)

Ativos de imagem de marketing em modo retrato alongado a serem usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 600 x 1.067, e a proporção precisa ser 9:16 (+-1%). Combinado com marketingImages, squareMarketingImages e portraitMarketingImages, 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 pelo menos 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 de exibição é 90. É possível especificar pelo menos uma e no máximo cinco descrições.
businessName

string

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

string

Texto da call-to-action.
leadFormOnly

boolean

Opção booleana que indica se esse anúncio precisa ser veiculado com o 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. Nome do anunciante/marca.
logoImage

object (AdImageAsset)

Obrigatório. 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 da call-to-action.
carouselCards[]

object (AdDemandGenCarouselCardAsset)

Obrigatório. Cards do carrossel que vão aparecer com o anúncio. Mínimo de 2 e máximo de 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 card de carrossel do Discovery.

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 para o título curto.
longHeadlines[]

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdVideoAsset)

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

object (AdImageAsset)

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 do 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. 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 viagem.