- Recurso: anúncio
- FinalAppUrl
- AppUrlOperatingSystemType
- CustomParameter
- AdType
- Dispositivo
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- CallConversionReportingState
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- MimeType
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo (link em inglês)
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- AdTextAsset
- ServedAssetFieldType
- AssetPerformanceLabel
- AdAssetPolicySummary
- PolicyTopicEntry
- PolicyTopicEntryType
- PolicyTopicEvidence
- WebsiteList
- TextList
- DestinationTextList
- DestinationMismatch
- PolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- PolicyTopicEvidenceDestinationNotWorkingDevice
- PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- PolicyTopicConstraint
- CountryConstraintList
- CountryConstraint
- ResellerConstraint
- PolicyReviewStatus
- PolicyApprovalStatus
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec (em inglês)
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- SmartCampaignAdInfo
- AppPreRegistrationAdInfo
- DiscoveryMultiAssetAdInfo
- DiscoveryCarouselAdInfo
- AdDiscoveryCarouselCardAsset
- DiscoveryVideoResponsiveAdInfo
- AdCallToActionAsset
- DemandGenProductAdInfo
- TravelAdInfo
- Métodos
Recurso: anúncio
Anúncio
Representação JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
Campos | |
---|---|
resourceName |
Imutável. O nome do recurso do anúncio. Os nomes dos recursos de anúncios têm o seguinte formato:
|
finalUrls[] |
A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio. |
finalAppUrls[] |
É 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[] |
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[] |
A lista de mapeamentos que podem ser usados para substituir tags de parâmetros personalizados em |
type |
Apenas saída. O tipo de anúncio. |
devicePreference |
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[] |
URLs adicionais para o anúncio que estão codificados com um identificador exclusivo que pode ser referenciado em outros campos no anúncio. |
systemManagedResourceSource |
Apenas saída. Se esse anúncio for gerenciado pelo sistema, este campo indicará a origem. Este campo é somente leitura. |
id |
Apenas saída. O ID do anúncio. |
trackingUrlTemplate |
O modelo de URL para criar um URL de rastreamento. |
finalUrlSuffix |
O sufixo a ser usado na criação de um URL final. |
displayUrl |
É o URL exibido na descrição de alguns formatos de anúncio. |
addedByGoogleAds |
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 |
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 deve ser definido. ad_data pode ser apenas de um dos tipos a seguir: |
|
textAd |
Imutável. Detalhes relacionados a um anúncio de texto. |
expandedTextAd |
Detalhes relacionados a um anúncio de texto expandido |
callAd |
Detalhes referentes a um anúncio de chamada. |
expandedDynamicSearchAd |
Imutável. Detalhes relacionados a um anúncio dinâmico expandido de pesquisa Esse tipo de anúncio tem título, URLs finais e URL de visualização gerado automaticamente no momento da veiculação de acordo com informações específicas do nome de domínio fornecidas por |
hotelAd |
Detalhes relacionados a um anúncio de hotel. |
shoppingSmartAd |
Detalhes relacionados a um anúncio inteligente do Shopping |
shoppingProductAd |
Detalhes relacionados a um anúncio de produto do Shopping. |
imageAd |
Imutável. Detalhes relacionados a um anúncio gráfico. |
videoAd |
Detalhes relacionados a um anúncio em vídeo. |
videoResponsiveAd |
Detalhes referentes a um anúncio responsivo em vídeo. |
responsiveSearchAd |
Detalhes relacionados a um anúncio responsivo de pesquisa |
legacyResponsiveDisplayAd |
Detalhes referentes a um anúncio responsivo de display legado. |
appAd |
Detalhes relacionados a um anúncio de aplicativo. |
legacyAppInstallAd |
Imutável. Detalhes referentes a um anúncio de instalação de apps legado. |
responsiveDisplayAd |
Detalhes relacionados a um anúncio responsivo de display |
localAd |
Detalhes relacionados a um anúncio local. |
displayUploadAd |
Detalhes relacionados a um anúncio de upload de display. |
appEngagementAd |
Detalhes relacionados a um anúncio de engajamento no app. |
shoppingComparisonListingAd |
Detalhes referentes a um anúncio de comparadores do Shopping. |
smartCampaignAd |
Detalhes relacionados a um anúncio de campanha inteligente |
appPreRegistrationAd |
Detalhes relacionados a um anúncio de pré-registro de app. |
discoveryMultiAssetAd |
Detalhes relacionados a um anúncio Discovery com vários recursos. |
discoveryCarouselAd |
Detalhes referentes a um anúncio Discovery de carrossel. |
discoveryVideoResponsiveAd |
Detalhes relativos a um anúncio responsivo em vídeo Discovery. |
demandGenProductAd |
Detalhes referentes a um anúncio de produto da Geração de demanda. |
travelAd |
Detalhes relacionados a um anúncio de viagem. |
FinalAppUrl
É um URL de link direto para um app de acordo com o sistema operacional em questão.
Representação JSON |
---|
{
"osType": enum ( |
Campos | |
---|---|
osType |
O sistema operacional segmentado por este URL. Obrigatório. |
url |
URL do link direto do aplicativo. Os links diretos especificam um local em um app que corresponde ao conteúdo que você quer mostrar e precisam ter o formato {scheme}://{host_path}. O esquema identifica qual app abrir. Para seu app, você pode usar um esquema personalizado que comece com o nome dele. O host e o caminho especificam o local no app em que seu conteúdo se encontra. Exemplo: "exampleapp://productid_1234". Obrigatório. |
AppUrlOperatingSystemType
Sistema operacional
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
IOS |
O sistema operacional Apple IOS. |
ANDROID |
O sistema operacional Android. |
CustomParameter
Um mapeamento que pode ser usado por tags de parâmetros personalizados em um trackingUrlTemplate
, finalUrls
ou mobile_final_urls
.
Representação JSON |
---|
{ "key": string, "value": string } |
Campos | |
---|---|
key |
A chave que corresponde ao nome da tag do parâmetro. |
value |
O valor a ser substituído. |
AdType
Os tipos possíveis de um anúncio.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
TEXT_AD |
Esse é um anúncio de texto. |
EXPANDED_TEXT_AD |
Este é um anúncio de texto expandido. |
EXPANDED_DYNAMIC_SEARCH_AD |
É um anúncio dinâmico expandido de pesquisa. |
HOTEL_AD |
O anúncio é de hotel. |
SHOPPING_SMART_AD |
Esse é um anúncio inteligente do Shopping. |
SHOPPING_PRODUCT_AD |
Este é um anúncio padrão do Shopping. |
VIDEO_AD |
Este é um anúncio em vídeo. |
IMAGE_AD |
Este é um anúncio gráfico. |
RESPONSIVE_SEARCH_AD |
Este é um anúncio responsivo de pesquisa. |
LEGACY_RESPONSIVE_DISPLAY_AD |
É um anúncio responsivo de display legado. |
APP_AD |
Esse é um anúncio de app. |
LEGACY_APP_INSTALL_AD |
Trata-se de um anúncio legado de instalação de apps. |
RESPONSIVE_DISPLAY_AD |
Esse é um anúncio responsivo de display. |
LOCAL_AD |
Este é um anúncio local. |
HTML5_UPLOAD_AD |
Este é um anúncio de upload de display com o tipo de produto HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
Este é um anúncio gráfico de upload com um dos tipos de produto DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
Trata-se de um anúncio de engajamento no app. |
SHOPPING_COMPARISON_LISTING_AD |
Este é um anúncio de comparadores do Shopping. |
VIDEO_BUMPER_AD |
Anúncio bumper em vídeo. |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
Anúncio em vídeo in-stream não pulável. |
VIDEO_OUTSTREAM_AD |
Anúncio em vídeo out-stream. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
Anúncio TrueView in-stream em vídeo. |
VIDEO_RESPONSIVE_AD |
Anúncio responsivo em vídeo. |
SMART_CAMPAIGN_AD |
Anúncio da campanha inteligente. |
CALL_AD |
Anúncio de chamada. |
APP_PRE_REGISTRATION_AD |
É o anúncio universal de pré-registro do app. |
IN_FEED_VIDEO_AD |
anúncio em vídeo In-feed. |
DISCOVERY_MULTI_ASSET_AD |
Anúncio Discovery com vários recursos. |
DISCOVERY_CAROUSEL_AD |
Anúncio Discovery de carrossel. |
TRAVEL_AD |
Anúncio de viagens. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Anúncio Discovery em vídeo. |
DEMAND_GEN_PRODUCT_AD |
Anúncio de produto da Geração de demanda. |
Dispositivo
Enumera os dispositivos do Google Ads disponíveis para segmentação.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
MOBILE |
Dispositivos móveis com navegadores completos. |
TABLET |
Tablets com navegadores completos. |
DESKTOP |
Computadores. |
CONNECTED_TV |
Smart TVs e consoles de jogos. |
OTHER |
Outros tipos de dispositivos. |
UrlCollection
Coleção de URLs marcados com um identificador exclusivo.
Representação JSON |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
Campos | |
---|---|
finalUrls[] |
Uma lista de possíveis URLs finais. |
finalMobileUrls[] |
Uma lista de possíveis URLs finais para dispositivos móveis. |
urlCollectionId |
Identificador exclusivo dessa instância de UrlCollection. |
trackingUrlTemplate |
Modelo de URL para criar um URL de rastreamento. |
SystemManagedResourceSource
Enumeração que lista as possíveis origens de entidades gerenciadas pelo sistema.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
AD_VARIATIONS |
Anúncio do experimento de variações do anúncio gerado. |
TextAdInfo
Um anúncio de texto.
Representação JSON |
---|
{ "headline": string, "description1": string, "description2": string } |
Campos | |
---|---|
headline |
Título do anúncio. |
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
ExpandedTextAdInfo
Anúncio de texto expandido.
Representação JSON |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
Campos | |
---|---|
headlinePart1 |
A primeira parte do título do anúncio. |
headlinePart2 |
A segunda parte do título do anúncio. |
headlinePart3 |
A terceira parte do título do anúncio. |
description |
Descrição do anúncio. |
description2 |
A segunda descrição do anúncio. |
path1 |
O texto que pode aparecer ao lado do URL exibido do anúncio. |
path2 |
Texto adicional que pode aparecer ao lado do URL exibido do anúncio. |
CallAdInfo
Anúncio de chamada.
Representação JSON |
---|
{
"countryCode": string,
"phoneNumber": string,
"businessName": string,
"headline1": string,
"headline2": string,
"description1": string,
"description2": string,
"callTracked": boolean,
"disableCallConversion": boolean,
"phoneNumberVerificationUrl": string,
"conversionAction": string,
"conversionReportingState": enum ( |
Campos | |
---|---|
countryCode |
O código do país no anúncio. |
phoneNumber |
É o número de telefone do anúncio. |
businessName |
Nome da empresa no anúncio. |
headline1 |
Primeiro título no anúncio. |
headline2 |
Segundo título do anúncio. |
description1 |
A primeira linha da descrição do anúncio. |
description2 |
Segunda linha da descrição do anúncio. |
callTracked |
Define se o rastreamento de chamadas para o criativo será ativado. Ativar o acompanhamento de chamadas também ativa as conversões de chamada. |
disableCallConversion |
Indica se a conversão de chamada do criativo será desativada. Se definido como |
phoneNumberVerificationUrl |
O URL a ser usado para a verificação do número de telefone. |
conversionAction |
A ação de conversão à qual atribuir uma conversão de chamada. Se ela não for definida, uma ação de conversão padrão será usada. Este campo só tem efeito se |
conversionReportingState |
O comportamento de conversão de chamada desse anúncio de chamada. Ela pode usar a própria configuração de conversões de chamada, herdar a configuração no nível da conta ou ser desativada. |
path1 |
Primeira parte do texto que pode ser anexada ao URL no anúncio. Opcional. |
path2 |
Segunda parte do texto que pode ser anexada ao URL no anúncio. Só é possível definir este campo quando |
CallConversionReportingState
Possíveis tipos de dados para um estado de ação de conversão de chamada.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
DISABLED |
A ação de conversão de chamada está desativada. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
A ação de conversão de chamada vai usar o tipo de conversão de chamada definido no nível da conta. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
A ação de conversão de chamada usará o tipo de conversão de chamada definido no nível do recurso (anúncios só para chamadas/extensões de chamada). |
ExpandedDynamicSearchAdInfo
Um anúncio dinâmico expandido de pesquisa.
Representação JSON |
---|
{ "description": string, "description2": string } |
Campos | |
---|---|
description |
Descrição do anúncio. |
description2 |
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 ( |
Campos | |
---|---|
mimeType |
O tipo MIME da imagem. |
pixelWidth |
Largura em pixels da imagem em tamanho original. |
pixelHeight |
Altura em pixels da imagem em tamanho original. |
imageUrl |
A URL da imagem em tamanho original. |
previewPixelWidth |
Largura em pixels da imagem com tamanho de visualização. |
previewPixelHeight |
Altura em pixels da imagem com tamanho de visualização. |
previewImageUrl |
URL da imagem do tamanho da visualização. |
name |
O nome da imagem. Se a imagem foi criada a partir de um MediaFile, esse é o nome do MediaFile. Se a imagem foi criada com base em bytes, o nome estará vazio. |
Campo de união image . A imagem a partir da qual o ImageAd será criado. Isso pode ser especificado de duas maneiras. 1. Um recurso MediaFile existente. 2. Os dados brutos da imagem como bytes. image pode ser apenas de um dos tipos a seguir: |
|
imageAsset |
Os recursos de imagem usados para o anúncio. |
data |
Dados brutos da imagem como bytes. Uma string codificada em base64. |
adIdToCopyImageFrom |
Um ID do anúncio do qual a imagem será copiada. |
MimeType
O tipo MIME
Enums | |
---|---|
UNSPECIFIED |
O tipo MIME não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
IMAGE_JPEG |
Tipo MIME de imagem/jpeg. |
IMAGE_GIF |
Tipo MIME de imagem/gif. |
IMAGE_PNG |
Tipo MIME de imagem/png. |
FLASH |
Tipo MIME de aplicativo/x-shockwave-flash. |
TEXT_HTML |
Tipo MIME de texto/html. |
PDF |
Tipo MIME de aplicativo/pdf. |
MSWORD |
Tipo MIME de aplicativo/msword. |
MSEXCEL |
Tipo MIME de application/vnd.ms-excel. |
RTF |
Tipo MIME de aplicativo/rtf. |
AUDIO_WAV |
Tipo MIME de áudio/wav. |
AUDIO_MP3 |
Tipo MIME de áudio/mp3. |
HTML5_AD_ZIP |
Tipo MIME de application/x-html5-ad-zip. |
AdImageAsset
Um recurso de imagem usado em um anúncio.
Representação JSON |
---|
{ "asset": string } |
Campos | |
---|---|
asset |
O nome do recurso do recurso desta imagem. |
VideoAdInfo
Um anúncio em vídeo.
Representação JSON |
---|
{ "video": { object ( |
Campos | |
---|---|
video |
Os recursos de vídeo do YouTube usados para o anúncio. |
Campo de união format . Esquema específico para os diferentes formatos de vídeo. format pode ser apenas de um dos tipos a seguir: |
|
inStream |
Formato de anúncio em vídeo TrueView in-stream. |
bumper |
Formato de anúncio bumper em vídeo in-stream. |
outStream |
Formato de anúncio em vídeo out-stream. |
nonSkippable |
Formato de anúncio em vídeo in-stream não pulável. |
inFeed |
formato do anúncio em vídeo In-feed. |
AdVideoAsset
Um recurso de vídeo usado em um anúncio.
Representação JSON |
---|
{ "asset": string } |
Campos | |
---|---|
asset |
O nome do recurso do recurso deste vídeo. |
VideoTrueViewInStreamAdInfo
Representação do formato de anúncio em vídeo TrueView in-stream (anúncio mostrado durante a reprodução do vídeo, geralmente no início, que exibe um botão "Pular" alguns segundos depois do início do vídeo).
Representação JSON |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
Campos | |
---|---|
actionButtonLabel |
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 |
Texto adicional exibido com o botão de CTA (call-to-action) para dar contexto e incentivar o clique no botão. |
companionBanner |
Os recursos de imagem do banner complementar usados com o anúncio. |
VideoBumperInStreamAdInfo
Representação do formato de anúncio bumper em vídeo in-stream (anúncio em vídeo in-stream não pulável muito curto).
Representação JSON |
---|
{
"companionBanner": {
object ( |
Campos | |
---|---|
companionBanner |
Os recursos de imagem do banner complementar usados com o anúncio. |
actionButtonLabel |
Rótulo no botão "Call-to-action" que leva o usuário ao URL final do anúncio em vídeo. |
actionHeadline |
Texto adicional exibido com o botão de CTA (call-to-action) para dar contexto e incentivar o clique no botão. |
VideoOutstreamAdInfo
Representação do formato do anúncio em vídeo out-stream (exibido ao lado de um feed com reprodução automática, sem som).
Representação JSON |
---|
{ "headline": string, "description": string } |
Campos | |
---|---|
headline |
Título do anúncio. |
description |
A linha de descrição. |
VideoNonSkippableInStreamAdInfo
Representação do formato de anúncio em vídeo in-stream não pulável (anúncio em vídeo in-stream não pulável de 15 segundos).
Representação JSON |
---|
{
"companionBanner": {
object ( |
Campos | |
---|---|
companionBanner |
Os recursos de imagem do banner complementar usados com o anúncio. |
actionButtonLabel |
Rótulo no botão "Call-to-action" que leva o usuário ao URL final do anúncio em vídeo. |
actionHeadline |
Texto adicional exibido com o botão "Call-to-action" para dar contexto e incentivar o clique no botão. |
InFeedVideoAdInfo
Representação do formato do anúncio em vídeo In-feed.
Representação JSON |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
Campos | |
---|---|
headline |
Título do anúncio. |
description1 |
Primeira linha de texto do anúncio. |
description2 |
Segunda linha de texto do anúncio. |
thumbnail |
Imagem da miniatura do vídeo a ser usada. |
VideoThumbnail
Enumeração que lista os tipos possíveis de uma miniatura de vídeo.
Enums | |
---|---|
UNSPECIFIED |
O tipo não foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
DEFAULT_THUMBNAIL |
A miniatura padrão. Podem ser gerados automaticamente ou enviados pelo usuário. |
THUMBNAIL_1 |
Miniatura 1, gerada a partir do vídeo. |
THUMBNAIL_2 |
Miniatura 2, gerada a partir do vídeo. |
THUMBNAIL_3 |
Miniatura 3, gerada a partir do vídeo. |
VideoResponsiveAdInfo
Um anúncio responsivo em vídeo.
Representação JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto usados no título curto. No momento, somente um valor para o título curto é compatível. |
longHeadlines[] |
Lista de recursos de texto usados no título longo. No momento, somente um valor para o título longo é aceito. |
descriptions[] |
Lista de recursos de texto usados na descrição. No momento, só há suporte para um valor para a descrição. |
callToActions[] |
Lista de recursos de texto usados para o botão, por exemplo, o botão "Call-to-action". Atualmente, apenas um valor para o botão é suportado. |
videos[] |
A lista dos recursos de vídeo do YouTube usados para o anúncio. Atualmente, só há suporte para um valor para o recurso de vídeo do YouTube. |
companionBanners[] |
Lista de recursos de imagem usados no banner complementar. Atualmente, somente um valor para o recurso de banner complementar é compatível. |
breadcrumb1 |
Primeira parte do texto que aparece no anúncio com o URL exibido. |
breadcrumb2 |
Segunda parte do texto que aparece no anúncio com o URL exibido. |
AdTextAsset
Um recurso de texto usado em um anúncio.
Representação JSON |
---|
{ "pinnedField": enum ( |
Campos | |
---|---|
pinnedField |
O campo fixado do recurso. Isso restringe o recurso a ser exibido apenas nesse campo. Vários recursos podem ser fixados no mesmo campo. Um recurso liberado ou fixado em um campo diferente não será veiculado em um campo em que algum outro recurso foi fixado. |
assetPerformanceLabel |
O rótulo de desempenho desse recurso de texto. |
policySummaryInfo |
O resumo da política deste recurso de texto. |
text |
Texto do recurso. |
ServedAssetFieldType
Os possíveis tipos de campo de recursos.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
HEADLINE_1 |
O recurso é usado no título 1. |
HEADLINE_2 |
O recurso é usado no título 2. |
HEADLINE_3 |
O recurso é usado no título 3. |
DESCRIPTION_1 |
O recurso é usado na descrição 1. |
DESCRIPTION_2 |
O recurso é usado na descrição 2. |
HEADLINE |
O recurso foi usado em um título. Use-o somente se houver apenas um título no anúncio. Caso contrário, use os enums HEADLINE_1, HEADLINE_2 ou HEADLINE_3 |
HEADLINE_IN_PORTRAIT |
O recurso foi usado como título na imagem em modo retrato. |
LONG_HEADLINE |
O recurso foi usado em um título longo (em MultiAssetResponsiveAd). |
DESCRIPTION |
O recurso foi usado em uma descrição. Use-o somente se houver apenas uma descrição no anúncio. Caso contrário, use os tipos enumerados DESCRIPTION_1 ou DESCRIPTION_@ |
DESCRIPTION_IN_PORTRAIT |
O recurso foi usado como descrição na imagem em modo retrato. |
BUSINESS_NAME_IN_PORTRAIT |
O recurso foi usado como nome da empresa na imagem em modo retrato. |
BUSINESS_NAME |
O recurso foi usado como nome da empresa. |
MARKETING_IMAGE |
O recurso foi usado como uma imagem de marketing. |
MARKETING_IMAGE_IN_PORTRAIT |
O recurso foi usado como uma imagem de marketing em modo retrato. |
SQUARE_MARKETING_IMAGE |
O recurso foi usado como uma imagem de marketing quadrada. |
PORTRAIT_MARKETING_IMAGE |
O recurso foi usado como uma imagem de marketing em modo retrato. |
LOGO |
O recurso foi usado como logotipo. |
LANDSCAPE_LOGO |
O recurso foi usado como um logotipo em modo paisagem. |
CALL_TO_ACTION |
O recurso foi usado como uma call-to-action. |
YOU_TUBE_VIDEO |
O recurso foi usado como um vídeo do YouTube. |
SITELINK |
Esse recurso é usado como sitelink. |
CALL |
Este recurso é usado como uma chamada. |
MOBILE_APP |
Este recurso é usado como um app para dispositivos móveis. |
CALLOUT |
Esse recurso é usado como frase de destaque. |
STRUCTURED_SNIPPET |
Esse recurso é usado como um snippet estruturado. |
PRICE |
Esse recurso é usado como preço. |
PROMOTION |
Este recurso é usado como promoção. |
AD_IMAGE |
Este recurso é usado como imagem. |
LEAD_FORM |
O recurso é usado como formulário de lead. |
BUSINESS_LOGO |
O recurso é usado como logotipo da empresa. |
AssetPerformanceLabel
Enumeração que descreve os possíveis rótulos de desempenho de um ativo, normalmente calculados no contexto de uma vinculação.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
PENDING |
Este recurso ainda não tem informações de desempenho. Isso pode ter acontecido porque ele ainda está em revisão. |
LEARNING |
O recurso começou a receber impressões, mas as estatísticas não têm significância estatística o suficiente para receber um rótulo de performance de recurso. |
LOW |
Recursos com pior performance. |
GOOD |
Recursos com boa performance. |
BEST |
Recursos com melhor performance. |
AdAssetPolicySummary
Contém informações de política para um recurso dentro de um anúncio.
Representação JSON |
---|
{ "policyTopicEntries": [ { object ( |
Campos | |
---|---|
policyTopicEntries[] |
A lista de descobertas de política para este recurso. |
reviewStatus |
Em que ponto do processo de revisão esse recurso está. |
approvalStatus |
O status geral de aprovação deste recurso, que é calculado com base no status das entradas individuais do tópico da política. |
PolicyTopicEntry
Descoberta de política anexada a um recurso (por exemplo, política de bebidas alcoólicas associada a um site que vende bebidas alcoólicas).
Cada PolicyTopicEntry tem um tópico que indica a política de anúncios específica da entrada e um tipo que indica o efeito que ela terá na veiculação. Ele pode, opcionalmente, ter uma ou mais evidências que indicam o motivo da descoberta. Ela também pode ter uma ou mais restrições que fornecem detalhes sobre como a veiculação pode ser restrita.
Representação JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type |
Descreve o efeito negativo ou positivo que essa política terá na veiculação. |
evidences[] |
Informações adicionais que explicam a descoberta da política (por exemplo, o nome da marca para uma descoberta de marca registrada) |
constraints[] |
Indica como a veiculação deste recurso pode ser afetada (por exemplo, não exibição em um país). |
topic |
Tópico de política a que esta descoberta se refere. Por exemplo, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT" ou "DESTINATION_NOT_WORKING". O conjunto de possíveis tópicos de política não é fixo para uma determinada versão da API e pode mudar a qualquer momento. |
PolicyTopicEntryType
Os possíveis tipos de entrada do tópico da política.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
PROHIBITED |
O recurso não será exibido. |
LIMITED |
O recurso não será exibido em algumas circunstâncias. |
FULLY_LIMITED |
O recurso não pode ser exibido devido aos critérios de segmentação atuais. |
DESCRIPTIVE |
Pode ser interessante, mas não limita a forma como o recurso é disponibilizado. |
BROADENING |
Pode aumentar a cobertura além do normal. |
AREA_OF_INTEREST_ONLY |
Restrito para todos os países de destino, mas pode veicular em outros países por área de interesse. |
PolicyTopicEvidence
Informações adicionais que explicam a descoberta de uma política.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união value . Informações específicas das evidências, dependendo do tipo de evidência. value pode ser apenas de um dos tipos a seguir: |
|
websiteList |
Lista de sites vinculados a este recurso. |
textList |
Lista de evidências encontradas no texto de um recurso. |
languageCode |
O idioma em que o recurso foi detectado como escrito. Essa é uma tag de idioma IETF, como "en-US". |
destinationTextList |
O texto no destino do recurso que está causando uma descoberta de política. |
destinationMismatch |
Incompatibilidade entre os destinos dos URLs de um recurso. |
destinationNotWorking |
Detalhes em que o destino retorna um código de erro HTTP ou não funciona em todos os locais dos dispositivos usados com frequência. |
WebsiteList
Uma lista de sites que causaram a descoberta de uma política. Usado para o tópico de política ONE_WEBSITE_PER_AD_GROUP, por exemplo. Caso haja mais de cinco sites, apenas os cinco principais (aqueles que mais aparecem nos recursos) serão listados aqui.
Representação JSON |
---|
{ "websites": [ string ] } |
Campos | |
---|---|
websites[] |
Sites que causaram a descoberta da política. |
TextList
Uma lista de fragmentos de texto que violaram uma política.
Representação JSON |
---|
{ "texts": [ string ] } |
Campos | |
---|---|
texts[] |
Os fragmentos de texto do recurso que causaram a descoberta da política. |
DestinationTextList
Uma lista de strings encontradas em uma página de destino que causou uma descoberta de política.
Representação JSON |
---|
{ "destinationTexts": [ string ] } |
Campos | |
---|---|
destinationTexts[] |
Lista de texto encontrado na página de destino do recurso. |
DestinationMismatch
Evidência de incompatibilidade entre os URLs de um recurso.
Representação JSON |
---|
{
"urlTypes": [
enum ( |
Campos | |
---|---|
urlTypes[] |
O conjunto de URLs que não corresponderam entre si. |
PolicyTopicEvidenceDestinationMismatchUrlType
Os possíveis tipos de URL que não correspondem às evidências do tópico da política.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
DISPLAY_URL |
O URL de visualização. |
FINAL_URL |
O URL final. |
FINAL_MOBILE_URL |
O URL final para dispositivos móveis. |
TRACKING_URL |
O modelo de URL de rastreamento, com o URL para computador substituído. |
MOBILE_TRACKING_URL |
O modelo de URL de rastreamento, com URL para dispositivos móveis substituído. |
DestinationNotWorking
São detalhes das evidências quando o destino retorna um código de erro HTTP ou não funciona em todos os locais dos dispositivos usados com frequência.
Representação JSON |
---|
{ "device": enum ( |
Campos | |
---|---|
device |
O tipo de dispositivo que falhou ao carregar o URL. |
expandedUrl |
O URL completo que não funcionou. |
lastCheckedDateTime |
A hora em que o URL foi verificado pela última vez. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30" |
Campo de união reason . Indica o motivo da descoberta da política de DESTINATION_NOT_WORKING. reason pode ser apenas de um dos tipos a seguir: |
|
dnsErrorType |
O tipo de erro de DNS. |
httpErrorCode |
O código do erro HTTP. |
PolicyTopicEvidenceDestinationNotWorkingDevice
O possível destino da evidência do tópico da política que não funciona com dispositivos.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
DESKTOP |
A página de destino não funciona em computadores. |
ANDROID |
A página de destino não funciona no dispositivo Android. |
IOS |
A página de destino não funciona em dispositivos iOS. |
PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
O possível destino da evidência do tópico da política que não funciona com tipos de erro de DNS.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
HOSTNAME_NOT_FOUND |
O nome do host não foi encontrado no DNS ao buscar a página de destino. |
GOOGLE_CRAWLER_DNS_ISSUE |
Problema com o rastreador interno do Google ao se comunicar com o DNS. Esse erro não significa que a página de destino não funciona. O Google vai rastrear novamente a página de destino. |
PolicyTopicConstraint
Descreve o efeito na veiculação que uma entrada de tópico da política terá.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união value . Informações específicas sobre a restrição. value pode ser apenas de um dos tipos a seguir: |
|
countryConstraintList |
Países em que o recurso não pode ser veiculado. |
resellerConstraint |
Restrição para revendedores. |
certificateMissingInCountryList |
Países em que um certificado é necessário para veiculação. |
certificateDomainMismatchInCountryList |
países em que o domínio do recurso não é coberto pelos certificados associados a ele. |
CountryConstraintList
Uma lista de países onde a veiculação de um recurso é restrita.
Representação JSON |
---|
{
"countries": [
{
object ( |
Campos | |
---|---|
countries[] |
Países em que a veiculação é restrita. |
totalTargetedCountries |
Número total de países segmentados pelo recurso. |
CountryConstraint
Indica que a capacidade de um recurso de ser veiculada em um país específico é limitada.
Representação JSON |
---|
{ "countryCriterion": string } |
Campos | |
---|---|
countryCriterion |
Nome do recurso constante da segmentação geográfica do país em que a veiculação está restrita. |
ResellerConstraint
Esse tipo não tem campos.
Indica que um tópico da política foi restringido devido à reprovação do site para fins de revenda.
PolicyReviewStatus
Os possíveis status da análise de compliance com a política.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
REVIEW_IN_PROGRESS |
Em revisão no momento. |
REVIEWED |
Revisão principal concluída. Outras análises podem continuar. |
UNDER_APPEAL |
O recurso foi reenviado para aprovação ou a decisão relacionada à política foi contestada. |
ELIGIBLE_MAY_SERVE |
O recurso está qualificado e pode estar sendo veiculado, mas ainda pode passar por uma análise mais detalhada. |
PolicyApprovalStatus
Os possíveis status de aprovação da política. Quando houver vários status de aprovação disponíveis, o mais grave será usado. A ordem de gravidade é DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED e APPROVED.
Enums | |
---|---|
UNSPECIFIED |
Nenhum valor foi especificado. |
UNKNOWN |
O valor recebido não é conhecido nesta versão. Esse é um valor apenas de resposta. |
DISAPPROVED |
Não será veiculado. |
APPROVED_LIMITED |
Funciona com restrições. |
APPROVED |
Veicula sem restrições. |
AREA_OF_INTEREST_ONLY |
Não será veiculado nos países de destino, mas poderá servir para usuários que estão pesquisando informações sobre esses países. |
ResponsiveSearchAdInfo
Um anúncio responsivo de pesquisa.
Com os anúncios responsivos de pesquisa, você pode criar um anúncio que se adapta para mostrar mais texto e mensagens mais relevantes aos seus clientes. Se você incluir vários títulos e descrições ao criar o anúncio, com o tempo, o Google Ads vai testar automaticamente diferentes combinações e vai aprender quais apresentam melhor performance. Quando você adapta o conteúdo do seu anúncio para que ele corresponda melhor aos termos de pesquisa dos clientes em potencial, os anúncios responsivos de pesquisa podem melhorar a performance da campanha.
Mais informações em https://support.google.com/google-ads/answer/7684791
Representação JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. |
descriptions[] |
Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista. |
path1 |
Primeira parte do texto que pode ser anexada ao URL no anúncio. |
path2 |
Segunda parte do texto que pode ser anexada ao URL no anúncio. Só é possível definir este campo quando |
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 ( |
Campos | |
---|---|
formatSetting |
Especifica em qual formato o anúncio será veiculado. O padrão é ALL_FORMATS. |
shortHeadline |
É a versão curta do título do anúncio. |
longHeadline |
É a versão longa do título do anúncio. |
description |
Descrição do anúncio. |
businessName |
Nome da empresa no anúncio. |
allowFlexibleColor |
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 é |
accentColor |
A cor de destaque do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se |
mainColor |
A cor principal do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se |
callToActionText |
O texto da call-to-action do anúncio. |
logoImage |
O nome do recurso MediaFile da imagem do logotipo usada no anúncio. |
squareLogoImage |
O nome do recurso do MediaFile da imagem do logotipo quadrada usada no anúncio. |
marketingImage |
O nome do recurso MediaFile da imagem de marketing usada no anúncio. |
squareMarketingImage |
O nome do recurso MediaFile da imagem de marketing quadrada usada no anúncio. |
pricePrefix |
Prefixo antes do preço. Por exemplo, "tão baixo quanto". |
promoText |
Texto da promoção usado para formatos dinâmicos dos anúncios responsivos. Por exemplo, "Envio em dois dias com frete grátis". |
DisplayAdFormatSetting
Enumera as configurações de formato do anúncio gráfico.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
ALL_FORMATS |
Texto, imagem e formatos nativos. |
NON_NATIVE |
Formatos de texto e imagem. |
NATIVE |
O formato nativo, por exemplo, é controlado pelo editor, e não pelo Google. |
AppAdInfo
Um anúncio de app.
Representação JSON |
---|
{ "mandatoryAdText": { object ( |
Campos | |
---|---|
mandatoryAdText |
Texto do anúncio obrigatório. |
headlines[] |
Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. |
descriptions[] |
Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista. |
images[] |
Lista de recursos de imagem que podem ser exibidos com o anúncio. |
youtubeVideos[] |
Lista de recursos de vídeo do YouTube que podem ser exibidos com o anúncio. |
html5MediaBundles[] |
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 |
O nome do recurso do recurso deste pacote de mídia. |
LegacyAppInstallAdInfo
Um anúncio de instalação de apps legado que só pode ser usado por alguns clientes selecionados.
Representação JSON |
---|
{
"appStore": enum ( |
Campos | |
---|---|
appStore |
A app store em que o app para dispositivos móveis está disponível. |
appId |
O ID do app para dispositivos móveis. |
headline |
Título do anúncio. |
description1 |
A primeira linha de descrição do anúncio. |
description2 |
A segunda linha de descrição do anúncio. |
LegacyAppInstallAdAppStore
Tipo de app store em um anúncio de instalação de apps legado.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
APPLE_APP_STORE |
iTunes da Apple. |
GOOGLE_PLAY |
Google Play |
WINDOWS_STORE |
Loja do Windows. |
WINDOWS_PHONE_STORE |
Loja do Windows Phone. |
CN_APP_STORE |
O aplicativo está hospedado em uma loja de aplicativos chinesa. |
ResponsiveDisplayAdInfo
Um anúncio responsivo de display
Representação JSON |
---|
{ "marketingImages": [ { object ( |
Campos | |
---|---|
marketingImages[] |
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 |
squareMarketingImages[] |
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 |
logoImages[] |
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[] |
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 |
headlines[] |
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 |
É um título de formato longo obrigatório. O comprimento máximo é de 90 caracteres. |
descriptions[] |
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[] |
Vídeos opcionais do YouTube para o anúncio. É possível especificar no máximo cinco vídeos. |
formatSetting |
Especifica em qual formato o anúncio será veiculado. O padrão é ALL_FORMATS. |
controlSpec |
Especificação para vários controles de criativos. |
businessName |
Nome do anunciante/marca. A largura máxima de exibição é 25. |
mainColor |
A cor principal do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se |
accentColor |
A cor de destaque do anúncio em hexadecimal, por exemplo, #ffffff para branco. Se |
allowFlexibleColor |
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 é |
callToActionText |
O texto da call-to-action do anúncio. A largura máxima de exibição é 30. |
pricePrefix |
Prefixo antes do preço. Por exemplo, "tão baixo quanto". |
promoText |
Texto da promoção usado para formatos dinâmicos dos anúncios responsivos. Por exemplo, "Envio em dois dias com frete grátis". |
ResponsiveDisplayAdControlSpec
Especificação para vários controles de criativo para um anúncio responsivo de display.
Representação JSON |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
Campos | |
---|---|
enableAssetEnhancements |
Indica se o anunciante ativou o recurso de melhorias de recurso. |
enableAutogenVideo |
Indica se o anunciante ativou o recurso de vídeo de geração automática. |
LocalAdInfo
Um anúncio local
Representação JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. É preciso especificar pelo menos um e no máximo cinco títulos. |
descriptions[] |
Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista. É preciso especificar pelo menos uma e no máximo cinco descrições. |
callToActions[] |
Lista de recursos de texto para calls-to-action. Quando o anúncio for veiculado, as calls-to-action serão selecionadas nessa lista. É necessário especificar pelo menos uma e no máximo cinco calls-to-action. |
marketingImages[] |
Lista de recursos de imagem de marketing que podem ser mostrados com o anúncio. As imagens precisam ter 314 x 600 pixels ou 320 x 320 pixels. É preciso especificar no mínimo 1 e no máximo 20 recursos de imagem. |
logoImages[] |
Lista de recursos de imagem do logotipo que podem ser mostrados com o anúncio. As imagens precisam ter 128 x 128 pixels e até 120 KB. É preciso especificar pelo menos um e no máximo cinco recursos de imagem. |
videos[] |
Lista de recursos de vídeo do YouTube que podem ser exibidos com o anúncio. É preciso especificar no mínimo 1 e no máximo 20 recursos de vídeo. |
path1 |
Primeira parte do texto opcional que pode ser anexado ao URL no anúncio. |
path2 |
Segunda parte do texto opcional que pode ser anexado ao URL no anúncio. Só é possível definir este campo quando |
DisplayUploadAdInfo
Um tipo genérico de anúncio de display. O formato exato do anúncio é controlado pelo campo displayUploadProductType
, que determina os tipos de dados que precisam ser incluídos.
Representação JSON |
---|
{ "displayUploadProductType": enum ( |
Campos | |
---|---|
displayUploadProductType |
O tipo de produto deste anúncio. Veja os comentários sobre a enumeração para saber mais detalhes. |
Campo de união media_asset . Os dados do recurso que compõe o anúncio. media_asset pode ser apenas de um dos tipos a seguir: |
|
mediaBundle |
Um recurso de pacote de mídia a ser usado no anúncio. Para informações sobre o pacote de mídia para HTML5_UPLOAD_AD, consulte https://support.google.com/google-ads/answer/1722096. Pacotes de mídia que fazem parte de tipos de produto dinâmicos usam um formato especial que precisa ser criado pelo Google Web Designer. Para mais informações, acesse https://support.google.com/webdesigner/answer/7543898. |
DisplayUploadProductType
Enumera os tipos de produto de upload de display.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
O valor é desconhecido nesta versão. |
HTML5_UPLOAD_AD |
Anúncio de upload HTML5. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. |
DYNAMIC_HTML5_EDUCATION_AD |
Anúncio de educação HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de educação. |
DYNAMIC_HTML5_FLIGHT_AD |
Anúncio de voo HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de veiculação em flights. |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
Anúncio de aluguel e hotel HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só podem ser usadas em uma campanha de hotel. |
DYNAMIC_HTML5_JOB_AD |
Anúncio de emprego HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usada em uma campanha de emprego. |
DYNAMIC_HTML5_LOCAL_AD |
Anúncio local HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só podem ser usados em uma campanha local. |
DYNAMIC_HTML5_REAL_ESTATE_AD |
Anúncio de imóveis HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha imobiliária. |
DYNAMIC_HTML5_CUSTOM_AD |
Anúncio personalizado HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só podem ser usados em uma campanha personalizada. |
DYNAMIC_HTML5_TRAVEL_AD |
Anúncio de viagem HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só pode ser usado em uma campanha de viagens. |
DYNAMIC_HTML5_HOTEL_AD |
Anúncio de hotel HTML5 dinâmico. Este tipo de produto requer que o campo upload_media_bundle em DisplayUploadAdInfo seja definido. Só podem ser usadas em uma campanha de hotel. |
AppEngagementAdInfo
Com os anúncios de engajamento no app, você pode escrever um texto incentivando uma ação específica no aplicativo, como fazer check-in, realizar uma compra ou reservar um voo. Com elas, você pode direcionar os usuários para uma parte específica do aplicativo onde eles podem encontrar o que estão procurando com mais facilidade e rapidez.
Representação JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. |
descriptions[] |
Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista. |
images[] |
Lista de recursos de imagem que podem ser exibidos com o anúncio. |
videos[] |
Lista de recursos de vídeo que podem ser exibidos com o anúncio. |
ShoppingComparisonListingAdInfo
Um anúncio de comparadores do Shopping.
Representação JSON |
---|
{ "headline": string } |
Campos | |
---|---|
headline |
Título do anúncio. Este campo é obrigatório. O tamanho permitido é de 25 a 45 caracteres. |
SmartCampaignAdInfo
Um anúncio de campanha inteligente
Representação JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto, cada um deles correspondente a um título quando o anúncio é veiculado. Essa lista consiste em no mínimo 3 e no máximo 15 recursos de texto. |
descriptions[] |
Lista de recursos de texto, cada um deles correspondente a uma descrição quando o anúncio é veiculado. Essa lista consiste em no mínimo dois e no máximo quatro recursos de texto. |
AppPreRegistrationAdInfo
Os anúncios de pré-registro do app são vinculados aos detalhes do app ou jogo no Google Play e podem ser exibidos no Google Play, no YouTube (somente in-stream) e em outros apps e sites para dispositivos móveis na Rede de Display. Isso ajuda a capturar o interesse das pessoas no seu app ou jogo e a gerar uma base instalada antecipada antes do lançamento.
Representação JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista. |
descriptions[] |
Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista. |
images[] |
Lista de códigos de recursos de imagem cujas imagens podem ser exibidas com o anúncio. |
youtubeVideos[] |
Lista de IDs de recursos de vídeo do YouTube cujos vídeos podem ser exibidos com o anúncio. |
DiscoveryMultiAssetAdInfo
Um anúncio Discovery com vários recursos.
Representação JSON |
---|
{ "marketingImages": [ { object ( |
Campos | |
---|---|
marketingImages[] |
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[] |
Recursos de imagem de marketing quadradas que serão usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 300 x 300, e a proporção precisa ser 1:1 (+-1%). Obrigatório se marketingImages não estiver presente. Combinado com |
portraitMarketingImages[] |
Recursos de imagem de marketing em modo retrato a serem usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é de 480 x 600, e a proporção precisa ser de 4:5 (+-1%). Combinado com |
logoImages[] |
Recursos de imagem do logotipo a serem usados no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 128 x 128, e a proporção precisa ser 1:1 (+-1%). É possível especificar no mínimo uma e no máximo cinco imagens de logotipo. |
headlines[] |
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[] |
O texto descritivo do anúncio. A largura máxima é 90. É possível especificar de uma a cinco descrições. |
businessName |
O nome do anunciante/marca. A largura máxima de exibição é 25. Obrigatório. |
callToActionText |
Texto de call-to-action. |
leadFormOnly |
Opção booleana que indica se o anúncio precisa ser veiculado com o formulário de lead. |
DiscoveryCarouselAdInfo
Um anúncio Discovery de carrossel.
Representação JSON |
---|
{ "businessName": string, "logoImage": { object ( |
Campos | |
---|---|
businessName |
Obrigatório. O nome do anunciante/marca. |
logoImage |
Obrigatório. A imagem do logotipo será usada no anúncio. O tamanho mínimo é 128 x 128, e a proporção precisa ser 1:1 (+-1%). |
headline |
Obrigatório. Título do anúncio. |
description |
Obrigatório. O texto descritivo do anúncio. |
callToActionText |
Texto de call-to-action. |
carouselCards[] |
Obrigatório. Cards de carrossel que vão ser exibidos com o anúncio Mín. 2 máx. 10. |
AdDiscoveryCarouselCardAsset
Um recurso Discovery de carrossel usado em um anúncio.
Representação JSON |
---|
{ "asset": string } |
Campos | |
---|---|
asset |
O nome do recurso de recurso deste card de descoberta do carrossel. |
DiscoveryVideoResponsiveAdInfo
Um anúncio responsivo em vídeo Discovery.
Representação JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto usados no título curto. |
longHeadlines[] |
Lista de recursos de texto usados no título longo. |
descriptions[] |
Lista de recursos de texto usados na descrição. |
videos[] |
A lista dos recursos de vídeo do YouTube usados para o anúncio. |
logoImages[] |
A imagem do logotipo será usada no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 128 x 128, e a proporção precisa ser 1:1 (+-1%). |
breadcrumb1 |
Primeira parte do texto que aparece no anúncio com o URL exibido. |
breadcrumb2 |
Segunda parte do texto que aparece no anúncio com o URL exibido. |
businessName |
Obrigatório. Nome do anunciante/marca. |
callToActions[] |
Recursos do tipo CallToActionAsset usados no botão "Call-to-action". |
AdCallToActionAsset
É um recurso de call-to-action usado em um anúncio.
Representação JSON |
---|
{ "asset": string } |
Campos | |
---|---|
asset |
O nome do recurso desse 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 ( |
Campos | |
---|---|
breadcrumb1 |
Primeira parte do texto que aparece no anúncio com o URL exibido. |
breadcrumb2 |
Segunda parte do texto que aparece no anúncio com o URL exibido. |
businessName |
Obrigatório. Nome do anunciante/marca. |
headline |
Obrigatório. Recurso de texto usado para o título curto. |
description |
Obrigatório. Recurso de texto usado para a descrição. |
logoImage |
Obrigatório. A imagem do logotipo será usada no anúncio. Os tipos de imagem válidos são GIF, JPEG e PNG. O tamanho mínimo é 128 x 128, e a proporção precisa ser 1:1 (+-1%). |
callToAction |
Recurso do tipo CallToActionAsset usado para o botão "Call-to-action". |
TravelAdInfo
Esse tipo não tem campos.
Um anúncio de viagens.
Métodos |
|
---|---|
|
Retorna o anúncio solicitado com todos os detalhes. |
|
Atualiza anúncios. |