- Representação JSON
- AssetType
- AssetPolicySummary
- AssetFieldTypePolicySummary
- YoutubeVideoAsset
- MediaBundleAsset
- ImageAsset
- ImageDimension
- TextAsset
- LeadFormAsset
- LeadFormCallToActionType
- LeadFormField
- LeadFormSingleChoiceAnswers
- LeadFormCustomQuestionField
- LeadFormDeliveryMethod
- WebhookDelivery
- LeadFormPostSubmitCallToActionType
- LeadFormDesiredIntent
- BookOnGoogleAsset
- PromotionAsset
- CalloutAsset
- StructuredSnippetAsset
- SitelinkAsset
- PageFeedAsset
- DynamicEducationAsset
- MobileAppAsset
- HotelCalloutAsset
- CallAsset
- PriceAsset
- PriceOffering
- CallToActionAsset
- DynamicRealEstateAsset
- DynamicCustomAsset
- DynamicHotelsAndRentalsAsset
- DynamicFlightsAsset
- DiscoveryCarouselCardAsset
- DynamicTravelAsset
- DynamicLocalAsset
- DynamicJobsAsset
- LocationAsset
- BusinessProfileLocation
- HotelPropertyAsset
O recurso é uma parte de um anúncio que pode ser compartilhado entre vários anúncios. Ele pode ser uma imagem (ImageAsset), um vídeo (YoutubeVideoAsset) etc. Os recursos são imutáveis e não podem ser removidos. Para interromper a veiculação de um recurso, remova-o da entidade que o utiliza.
Representação JSON |
---|
{ "resourceName": string, "type": enum ( |
Campos | |
---|---|
resourceName |
Imutável. O nome do recurso. Os nomes dos recursos de recursos têm a seguinte forma:
|
type |
Apenas saída. Tipo do recurso. |
finalUrls[] |
Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios. |
finalMobileUrls[] |
Uma lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios. |
urlCustomParameters[] |
Uma lista de mapeamentos a serem usados para substituir tags de parâmetros personalizados de URL no TrackingUrlTemplate, finalUrls e/ou finalMobileUrls. |
source |
Apenas saída. Origem do recurso. |
policySummary |
Apenas saída. Informações da política para o recurso. |
fieldTypePolicySummaries[] |
Apenas saída. Informações da política do recurso para cada FieldType. |
id |
Apenas saída. O ID do recurso. |
name |
Nome opcional do recurso. |
trackingUrlTemplate |
Modelo de URL para criar um URL de rastreamento. |
finalUrlSuffix |
Modelo de URL para anexar parâmetros aos URLs da página de destino veiculados com acompanhamento paralelo. |
Campo de união asset_data . O tipo específico do recurso. asset_data pode ser apenas de um dos tipos a seguir: |
|
youtubeVideoAsset |
Imutável. Um recurso de vídeo do YouTube. |
mediaBundleAsset |
Imutável. Um recurso de pacote de mídia. |
imageAsset |
Apenas saída. Um recurso de imagem. |
textAsset |
Imutável. Um recurso de texto. |
leadFormAsset |
Um recurso de formulário de lead. |
bookOnGoogleAsset |
Um livro sobre recursos do Google. |
promotionAsset |
Um recurso de promoção. |
calloutAsset |
Um recurso de frase de destaque. |
structuredSnippetAsset |
Um recurso de snippet estruturado. |
sitelinkAsset |
Um recurso de sitelink. |
pageFeedAsset |
Um recurso de feed de páginas. |
dynamicEducationAsset |
Um recurso educacional dinâmico. |
mobileAppAsset |
Um recurso de link para app para dispositivos móveis. |
hotelCalloutAsset |
Um recurso de frase de destaque de hotel. |
callAsset |
Um recurso de ligação. |
priceAsset |
Um recurso de preço. |
callToActionAsset |
Imutável. Um recurso de call-to-action. |
dynamicRealEstateAsset |
Um recurso imobiliário dinâmico. |
dynamicCustomAsset |
Um recurso personalizado dinâmico. |
dynamicHotelsAndRentalsAsset |
Um recurso dinâmico de hotéis e aluguéis. |
dynamicFlightsAsset |
Um recurso de voos dinâmicos. |
discoveryCarouselCardAsset |
Imutável. Um recurso de card Discovery de carrossel. |
dynamicTravelAsset |
Um recurso de viagem dinâmico. |
dynamicLocalAsset |
Um recurso local dinâmico. |
dynamicJobsAsset |
Um recurso de vagas dinâmicas. |
locationAsset |
Apenas saída. Um recurso de local. |
hotelPropertyAsset |
Imutável. Um recurso de propriedade do hotel. |
AssetType
Enumeração que descreve possíveis tipos de ativos.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
YOUTUBE_VIDEO |
recurso de vídeo do YouTube. |
MEDIA_BUNDLE |
Recurso do pacote de mídia. |
IMAGE |
Recurso de imagem. |
TEXT |
Recurso de texto. |
LEAD_FORM |
Recurso de formulário de lead. |
BOOK_ON_GOOGLE |
Recurso do recurso Reservas no Google. |
PROMOTION |
Recurso de promoção. |
CALLOUT |
Recurso de frase de destaque. |
STRUCTURED_SNIPPET |
Recurso de snippet estruturado. |
SITELINK |
Recurso de sitelink. |
PAGE_FEED |
recurso do feed de páginas. |
DYNAMIC_EDUCATION |
do Dynamic Education. |
MOBILE_APP |
Recurso de link para app para dispositivos móveis. |
HOTEL_CALLOUT |
Recurso de frase de destaque de hotel. |
CALL |
Recurso de ligação. |
PRICE |
Recurso de preço |
CALL_TO_ACTION |
Recurso de call-to-action. |
DYNAMIC_REAL_ESTATE |
Recurso imobiliário dinâmico. |
DYNAMIC_CUSTOM |
Recurso personalizado dinâmico. |
DYNAMIC_HOTELS_AND_RENTALS |
Recurso de hotéis e aluguéis dinâmicos. |
DYNAMIC_FLIGHTS |
Recurso de voos dinâmicos. |
DISCOVERY_CAROUSEL_CARD |
Recurso do card de carrossel do Discovery. |
DYNAMIC_TRAVEL |
Recurso de viagem dinâmico. |
DYNAMIC_LOCAL |
Recurso local dinâmico. |
DYNAMIC_JOBS |
Recurso de vagas dinâmicas. |
LOCATION |
Recurso de local. |
HOTEL_PROPERTY |
Recurso de propriedade do hotel. |
AssetPolicySummary
Contém informações de política para um recurso.
Representação JSON |
---|
{ "policyTopicEntries": [ { object ( |
Campos | |
---|---|
policyTopicEntries[] |
Apenas saída. A lista de descobertas de política para este recurso. |
reviewStatus |
Apenas saída. Em que ponto do processo de revisão esse recurso está. |
approvalStatus |
Apenas saída. O status geral de aprovação desse recurso, calculado com base no status das entradas individuais do tópico da política. |
AssetFieldTypePolicySummary
Contém informações de política para um recurso no contexto AssetFieldType.
Representação JSON |
---|
{ "assetFieldType": enum ( |
Campos | |
---|---|
assetFieldType |
Apenas saída. FieldType deste recurso. |
assetSource |
Apenas saída. Origem desse recurso. |
policySummaryInfo |
Apenas saída. Resumo da política. |
YoutubeVideoAsset
Um recurso do YouTube.
Representação JSON |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
Campos | |
---|---|
youtubeVideoTitle |
Título do vídeo do YouTube. |
youtubeVideoId |
ID do vídeo do YouTube. Este é um valor de string de 11 caracteres usado no URL do vídeo do YouTube. |
MediaBundleAsset
Um recurso MediaBundle.
Representação JSON |
---|
{ "data": string } |
Campos | |
---|---|
data |
Dados do recurso do pacote de mídia (arquivo ZIP). O formato do arquivo ZIP enviado depende do campo do anúncio em que ele será usado. Para obter mais informações sobre o formato, consulte a documentação do campo do anúncio no qual você planeja usar o MediaBundleAsset. Este campo é somente mutate. Uma string codificada em base64. |
ImageAsset
Um recurso de imagem.
Representação JSON |
---|
{ "mimeType": enum ( |
Campos | |
---|---|
mimeType |
Tipo MIME do recurso de imagem. |
fullSize |
Metadados desta imagem no tamanho original. |
data |
Os dados brutos de bytes de uma imagem. Este campo é somente mutate. Uma string codificada em base64. |
fileSize |
Tamanho do arquivo do recurso de imagem em bytes. |
ImageDimension
Metadados de uma imagem em determinado tamanho, original ou redimensionado.
Representação JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Campos | |
---|---|
heightPixels |
É a altura da imagem. |
widthPixels |
É a largura da imagem. |
url |
Um URL que retorna a imagem com essa altura e largura. |
TextAsset
Um recurso de texto.
Representação JSON |
---|
{ "text": string } |
Campos | |
---|---|
text |
Conteúdo do recurso de texto. |
LeadFormAsset
Um recurso de formulário de lead.
Representação JSON |
---|
{ "businessName": string, "callToActionType": enum ( |
Campos | |
---|---|
businessName |
Obrigatório. O nome da empresa anunciada. |
callToActionType |
Obrigatório. Texto de exibição predefinido que incentiva o usuário a expandir o formulário. |
callToActionDescription |
Obrigatório. Texto que apresenta uma proposta de valor clara do que os usuários esperam quando expandem o formulário. |
headline |
Obrigatório. Título do formulário expandido para descrever o que está pedindo ou facilitando. |
description |
Obrigatório. Descrição detalhada do formulário expandido para descrever o que ele está pedindo ou facilitando. |
privacyPolicyUrl |
Obrigatório. Link para uma página que descreve a política sobre como o anunciante/empresa lida com os dados coletados. |
fields[] |
Lista ordenada de campos de entrada. Esse campo pode ser atualizado ao reordenar as perguntas, mas não ao adicionar ou remover perguntas. |
customQuestionFields[] |
Lista ordenada de campos de perguntas personalizadas. Este campo está sujeito a um limite de cinco perguntas de qualificação por formulário. |
deliveryMethods[] |
Métodos configurados para entregar os dados de lead coletados ao anunciante Somente um método digitado como WebhookDelivery pode ser configurado. |
postSubmitCallToActionType |
Texto de exibição predefinido que incentiva o usuário a realizar ações após o envio do formulário. |
desiredIntent |
Intenção escolhida para o formulário de lead, por exemplo, mais volume ou mais qualificados. |
postSubmitHeadline |
Título de texto exibido após o envio do formulário que descreve como o anunciante vai entrar em contato com o usuário. |
postSubmitDescription |
Descrição detalhada mostrada após o envio do formulário que descreve como o anunciante vai entrar em contato com o usuário. |
backgroundImageAsset |
Nome do recurso da imagem de plano de fundo. As dimensões da imagem precisam ser exatamente 1.200 x 628. |
customDisclosure |
Declaração personalizada exibida com a exoneração de responsabilidade do Google no formulário de lead. Acessível apenas a clientes autorizados. |
LeadFormCallToActionType
Enumeração que descreve o tipo de frases de call-to-action em um formulário de lead.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
LEARN_MORE |
Saiba mais. |
GET_QUOTE |
Peça um orçamento. |
APPLY_NOW |
Inscreva-se agora. |
SIGN_UP |
Inscreva-se. |
CONTACT_US |
Fale com nossa equipe. |
SUBSCRIBE |
Inscrever-se. |
DOWNLOAD |
Fazer o download. |
BOOK_NOW |
Reserve agora. |
GET_OFFER |
Aproveite a oferta. |
REGISTER |
Cadastre-se. |
GET_INFO |
Mais informações. |
REQUEST_DEMO |
Solicite uma demonstração. |
JOIN_NOW |
Participe agora. |
GET_STARTED |
Primeiros passos. |
LeadFormField
Uma instância de campo de entrada em um formulário.
Representação JSON |
---|
{ "inputType": enum ( |
Campos | |
---|---|
inputType |
Descreve o tipo de entrada, que pode ser um tipo predefinido como "nome completo" ou uma pergunta já verificada, como "Que tipo de veículo você tem?". |
Campo de união answers . Define a configuração de resposta que esse campo de formulário aceita. Se oneof não for definido, a resposta será em texto livre. answers pode ser apenas de um dos tipos a seguir: |
|
singleChoiceAnswers |
Configuração de resposta para uma pergunta de escolha única. Só pode ser definido para campos de perguntas pré-selecionadas. São necessárias no mínimo duas respostas e no máximo 12. |
hasLocationAnswer |
Configuração de resposta para a pergunta de localização. Se verdadeiro, os dados de local no nível da campanha/conta (estado, cidade, nome da empresa etc.) serão renderizados no formulário de lead. A partir da versão 13.1, hasLocationAnswer só pode ser definida para perguntas "Qual é sua concessionária preferida?" para anunciantes com recursos de local configurados no nível da campanha/conta. |
LeadFormSingleChoiceAnswers
Define as respostas possíveis para uma pergunta de escolha única, geralmente apresentada como uma lista suspensa de escolha única.
Representação JSON |
---|
{ "answers": [ string ] } |
Campos | |
---|---|
answers[] |
Lista de opções para um único campo de pergunta. A ordem das entradas define a ordem da interface. São necessárias no mínimo duas respostas e no máximo 12. |
LeadFormCustomQuestionField
Uma instância de campo de entrada de pergunta personalizada em um formulário.
Representação JSON |
---|
{ "customQuestionText": string, // Union field |
Campos | |
---|---|
customQuestionText |
O texto exato do campo da pergunta personalizada (por exemplo, "Que tipo de veículo você tem?"). |
Campo de união answers . Define a configuração de resposta que esse campo de formulário aceita. Se oneof não for definido, a resposta será em texto livre. answers pode ser apenas de um dos tipos a seguir: |
|
singleChoiceAnswers |
Configuração de resposta para uma pergunta de escolha única. São permitidas no mínimo 2 respostas e no máximo 12. |
hasLocationAnswer |
Configuração de resposta para a pergunta de localização. Se verdadeiro, os dados de local no nível da campanha/conta (estado, cidade, nome da empresa etc.) serão renderizados no formulário de lead. A partir da versão 13.1, hasLocationAnswer só pode ser definida para perguntas "Qual é sua concessionária preferida?" para anunciantes com recursos de local configurados no nível da campanha/conta. |
LeadFormDeliveryMethod
Uma configuração de como os leads são entregues ao anunciante.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união delivery_details . Diversos subtipos de exibição. delivery_details pode ser apenas de um dos tipos a seguir: |
|
webhook |
Método de entrega do webhook. |
WebhookDelivery
O Google notifica o anunciante sobre leads fazendo chamadas HTTP para um endpoint especificado por ele. As solicitações contêm JSON que corresponde a um esquema publicado pelo Google como parte da documentação dos anúncios de formulário.
Representação JSON |
---|
{ "advertiserWebhookUrl": string, "googleSecret": string, "payloadSchemaVersion": string } |
Campos | |
---|---|
advertiserWebhookUrl |
URL do webhook especificado pelo anunciante para enviar o lead. |
googleSecret |
Secret antispoofing definido pelo anunciante como parte do payload do webhook. |
payloadSchemaVersion |
A versão do esquema que esta instância de entrega usará. |
LeadFormPostSubmitCallToActionType
Enumeração que descreve o tipo de frases de call-to-action exibidas para um formulário de lead.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
VISIT_SITE |
Visite o site. |
DOWNLOAD |
Fazer o download. |
LEARN_MORE |
Saiba mais. |
SHOP_NOW |
Aproveite agora mesmo. |
LeadFormDesiredIntent
Enumeração que descreve o nível escolhido de intenção de leads gerados.
Enums | |
---|---|
UNSPECIFIED |
Não especificado. |
UNKNOWN |
Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão. |
LOW_INTENT |
Gerar mais leads com uma qualidade potencialmente mais baixa. |
HIGH_INTENT |
Gerar leads mais qualificados. |
BookOnGoogleAsset
Esse tipo não tem campos.
Um recurso do recurso Reservas no Google. Usado para redirecionar o usuário para reservar pelo Google. O recurso Reservas no Google vai mudar o URL de redirecionamento para fazer a reserva diretamente pelo Google.
PromotionAsset
Um recurso de promoção.
Representação JSON |
---|
{ "promotionTarget": string, "discountModifier": enum ( |
Campos | |
---|---|
promotionTarget |
Obrigatório. Uma descrição livre do que a promoção segmenta. |
discountModifier |
Um modificador da qualificação do desconto. |
redemptionStartDate |
Data de início do resgate da promoção, no formato aaaa-MM-dd. |
redemptionEndDate |
Última data de quando a promoção se qualifica para ser resgatada, no formato aaaa-MM-dd. |
occasion |
A ocasião em que a promoção foi criada. Se uma ocasião for definida, a janela de resgate precisará estar dentro do período associado a ela. |
languageCode |
Idioma da promoção. Representado como tag de idioma BCP 47. |
startDate |
Data de início do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd. |
endDate |
Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd. |
adScheduleTargets[] |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total. |
Campo de união discount_type . O tipo de desconto pode ser uma porcentagem ou um valor do desconto. discount_type só pode ser uma das seguintes opções: |
|
percentOff |
Porcentagem de desconto na promoção. 1.000.000 = 100%. É obrigatório adicionar este valor ou o paymentAmountOff. |
moneyAmountOff |
Valor do desconto na promoção. É obrigatório usar isso ou percentOff. |
Campo de união promotion_trigger . Acionador da promoção. Pode ser por código promocional ou promoção por valor qualificado do pedido. promotion_trigger pode ser apenas de um dos tipos a seguir: |
|
promotionCode |
Um código que o usuário deve usar para se qualificar para a promoção. |
ordersOverAmount |
É o valor total do pedido para que o usuário se qualifique para a promoção. |
CalloutAsset
Um recurso de frase de destaque.
Representação JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Campos | |
---|---|
calloutText |
Obrigatório. O texto da frase de destaque. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
startDate |
Data de início do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd. |
endDate |
Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd. |
adScheduleTargets[] |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total. |
StructuredSnippetAsset
Um recurso de snippet estruturado.
Representação JSON |
---|
{ "header": string, "values": [ string ] } |
Campos | |
---|---|
header |
Obrigatório. Cabeçalho do snippet. Essa string precisa ser um dos valores predefinidos em https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers |
values[] |
Obrigatório. Os valores no snippet. O tamanho dessa coleção deve estar entre 3 e 10, inclusive. O tamanho de cada valor deve ter de 1 a 25 caracteres, inclusive. |
SitelinkAsset
Um recurso de sitelink.
Representação JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Campos | |
---|---|
linkText |
Obrigatório. Texto de visualização do URL para o sitelink. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
description1 |
Primeira linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, inclusivo, e a description2 também precisa ser definida. |
description2 |
Segunda linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, sendo inclusivo, e a description1 também precisa ser definida. |
startDate |
Data de início do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd. |
endDate |
Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd. |
adScheduleTargets[] |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total. |
PageFeedAsset
Um recurso de feed de páginas.
Representação JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Campos | |
---|---|
pageUrl |
Obrigatório. A página da Web que os anunciantes querem segmentar. |
labels[] |
Rótulos usados para agrupar os URLs da página. |
DynamicEducationAsset
Um recurso Dynamic Education.
Representação JSON |
---|
{ "programId": string, "locationId": string, "programName": string, "subject": string, "programDescription": string, "schoolName": string, "address": string, "contextualKeywords": [ string ], "androidAppLink": string, "similarProgramIds": [ string ], "iosAppLink": string, "iosAppStoreId": string, "thumbnailImageUrl": string, "imageUrl": string } |
Campos | |
---|---|
programId |
Obrigatório. O ID do programa, que pode ser qualquer sequência de letras e dígitos, deve ser exclusivo e corresponder aos valores da tag de remarketing. Obrigatório. |
locationId |
O ID do local, que pode ser qualquer sequência de letras e dígitos e precisa ser exclusivo. |
programName |
Obrigatório. Nome do programa, por exemplo, Enfermagem. Obrigatório. |
subject |
Assunto do estudo, por exemplo, Saúde. |
programDescription |
Descrição do programa, por exemplo, Curso de enfermagem. |
schoolName |
Nome da escola, por exemplo, Escola de Enfermagem de Mountain View. |
address |
O endereço da escola, que pode ser especificado em um dos formatos a seguir. (1) Cidade, estado, código, país, por exemplo, Mountain View, CA, EUA. (2) Endereço completo, por exemplo, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude no formato DDD, por exemplo, 41.40338, 2.17403 |
contextualKeywords[] |
Palavras-chave contextuais, por exemplo, enfermagem, saúde, Mountain View. |
androidAppLink |
Link direto do Android, por exemplo, android-app://com.example.android/http/example.com/gizmos?1234. |
similarProgramIds[] |
IDs de programas semelhantes. |
iosAppLink |
Link direto do iOS, por exemplo, exampleApp://content/page. |
iosAppStoreId |
ID da App Store para iOS. É um número usado para verificar se o app está instalado no dispositivo antes de o usuário criar o link direto. Se este campo estiver definido, o campo iosAppLink também precisará estar presente. |
thumbnailImageUrl |
URL da imagem da miniatura, por exemplo, http://www.example.com/thumbnail.png. A imagem em miniatura não será enviada como recurso de imagem. |
imageUrl |
URL da imagem, por exemplo, http://www.example.com/image.png. A imagem não será enviada como recurso de imagem. |
MobileAppAsset
Um recurso que representa um app para dispositivos móveis.
Representação JSON |
---|
{
"appId": string,
"appStore": enum ( |
Campos | |
---|---|
appId |
Obrigatório. Uma string que identifica exclusivamente um aplicativo para dispositivos móveis. Ele deve conter apenas o ID nativo da plataforma, como "com.android.ebay" para Android ou "12345689" para iOS. |
appStore |
Obrigatório. A loja de aplicativos que distribui o aplicativo específico. |
linkText |
Obrigatório. O texto visível exibido quando o link é renderizado em um anúncio. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
startDate |
Data de início do período em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd. |
endDate |
Última data de quando esse recurso entra em vigor e ainda é veiculado, no formato aaaa-MM-dd. |
HotelCalloutAsset
Um recurso que representa uma frase de destaque de hotel.
Representação JSON |
---|
{ "text": string, "languageCode": string } |
Campos | |
---|---|
text |
Obrigatório. O texto do recurso de frase de destaque de hotel. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
languageCode |
Obrigatório. Idioma da frase de destaque do hotel. Representado como tag de idioma BCP 47. |
CallAsset
Um recurso de ligação.
Representação JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Campos | |
---|---|
countryCode |
Obrigatório. Código do país de duas letras do número de telefone. Exemplos: "BR", "us". |
phoneNumber |
Obrigatório. O número de telefone bruto do anunciante. Exemplos: "1234567890", "(123)456-7890" |
callConversionReportingState |
Indica se esse CallAsset deve usar uma configuração própria de conversão de chamada, seguir a configuração no nível da conta ou desativar a conversão de chamada. |
callConversionAction |
A ação de conversão à qual atribuir uma conversão de chamada. Se deixada sem definição, a ação de conversão padrão vai ser usada. Esse campo só terá efeito se callConversionReportingState estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
Lista de programações não sobrepostas que especificam todos os intervalos de tempo em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total. |
PriceAsset
Um recurso que representa uma lista de ofertas de preço.
Representação JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type |
Obrigatório. O tipo de recurso de preço. |
priceQualifier |
O qualificador do recurso de preço. |
languageCode |
Obrigatório. O idioma do recurso de preço. Representado como tag de idioma BCP 47. |
priceOfferings[] |
As ofertas de preço do recurso de preço. O tamanho desta coleção deve ser entre 3 e 8, inclusive. |
PriceOffering
Uma oferta de preço única em um PriceAsset.
Representação JSON |
---|
{ "header": string, "description": string, "price": { object ( |
Campos | |
---|---|
header |
Obrigatório. O cabeçalho da oferta de preço. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
description |
Obrigatório. A descrição da oferta de preço. Esta string conter entre 1 e 25 caracteres (valores inclusivos). |
price |
Obrigatório. O preço da oferta. |
unit |
A unidade de preço da oferta de preço. |
finalUrl |
Obrigatório. O URL final após todos os redirecionamentos entre domínios. |
finalMobileUrl |
O URL final para dispositivos móveis após todos os redirecionamentos entre domínios. |
CallToActionAsset
Um recurso de call-to-action.
Representação JSON |
---|
{
"callToAction": enum ( |
Campos | |
---|---|
callToAction |
Call-to-action |
DynamicRealEstateAsset
Um recurso imobiliário dinâmico.
Representação JSON |
---|
{ "listingId": string, "listingName": string, "cityName": string, "description": string, "address": string, "price": string, "imageUrl": string, "propertyType": string, "listingType": string, "contextualKeywords": [ string ], "formattedPrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarListingIds": [ string ] } |
Campos | |
---|---|
listingId |
Obrigatório. O ID da ficha da empresa, que pode ser qualquer sequência de letras e dígitos, precisa ser exclusivo e corresponder aos valores da tag de remarketing. Obrigatório. |
listingName |
Obrigatório. Nome da ficha, por exemplo, Boulevard Bungalow. Obrigatório. |
cityName |
Nome da cidade, por exemplo, Mountain View, Califórnia. |
description |
Descrição, por exemplo, 3 camas, 2 banheiros e 145 m2 |
address |
Endereço que pode ser especificado em um dos formatos a seguir. (1) Cidade, estado, código, país, por exemplo, Mountain View, CA, EUA. (2) Endereço completo, por exemplo, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude no formato DDD, por exemplo, 41.40338, 2.17403 |
price |
Preço que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 200.000.00 USD. |
imageUrl |
URL da imagem, por exemplo, http://www.example.com/image.png. A imagem não será enviada como recurso de imagem. |
propertyType |
Tipo de propriedade, por exemplo, Casa. |
listingType |
Tipo da ficha da empresa, por exemplo, para venda. |
contextualKeywords[] |
Palavras-chave contextuais, por exemplo, "Venda" ou "Casas à venda". |
formattedPrice |
Preço formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "price", por exemplo, a partir de US $200.000,00. |
androidAppLink |
Link direto do Android, por exemplo, android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Link direto do iOS, por exemplo, exampleApp://content/page. |
iosAppStoreId |
ID da App Store para iOS. É um número usado para verificar se o app está instalado no dispositivo antes de o usuário criar o link direto. Se este campo estiver definido, o campo iosAppLink também precisará estar presente. |
similarListingIds[] |
IDs de fichas semelhantes. |
DynamicCustomAsset
Um recurso personalizado dinâmico.
Representação JSON |
---|
{ "id": string, "id2": string, "itemTitle": string, "itemSubtitle": string, "itemDescription": string, "itemAddress": string, "itemCategory": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "imageUrl": string, "contextualKeywords": [ string ], "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarIds": [ string ] } |
Campos | |
---|---|
id |
Obrigatório. É um ID que pode ser qualquer sequência de letras e dígitos, precisa ser exclusivo e corresponder aos valores da tag de remarketing, por exemplo, sedã. Obrigatório. |
id2 |
O ID2, que pode ser qualquer sequência de letras e dígitos, por exemplo, vermelho. A sequência de IDs (ID + ID2) precisa ser exclusiva. |
itemTitle |
Obrigatório. Título do item, por exemplo, sedã médio. Obrigatório. |
itemSubtitle |
Subtítulo do item, por exemplo, "Na sua concessionária Mountain View". |
itemDescription |
Descrição do item, por exemplo, carro médio mais vendido. |
itemAddress |
Endereço do item que pode ser especificado em um dos formatos a seguir. (1) Cidade, estado, código, país, por exemplo, Mountain View, CA, EUA. (2) Endereço completo, por exemplo, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude no formato DDD, por exemplo, 41.40338, 2.17403 |
itemCategory |
Categoria do item, por exemplo, sedãs. |
price |
Preço que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 20.000.00 USD. |
salePrice |
Preço promocional que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 15.000,00 USD. Precisa ser menor que o campo "price". |
formattedPrice |
Preço formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "price", por exemplo, "A partir de US $20.000,00". |
formattedSalePrice |
Preço promocional formatado, que pode ser qualquer caractere. Se definido, o atributo será usado em vez de "sale price", por exemplo, Em promoção por R $15.000,00. |
imageUrl |
URL da imagem, por exemplo, http://www.example.com/image.png. A imagem não será enviada como recurso de imagem. |
contextualKeywords[] |
Palavras-chave contextuais, como "sedãs" e "sedãs de quatro portas". |
androidAppLink |
Link direto do Android, por exemplo, android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Link direto do iOS, por exemplo, exampleApp://content/page. |
iosAppStoreId |
ID da App Store para iOS. É um número usado para verificar se o app está instalado no dispositivo antes de o usuário criar o link direto. Se este campo estiver definido, o campo iosAppLink também precisará estar presente. |
similarIds[] |
IDs semelhantes. |
DynamicHotelsAndRentalsAsset
Um recurso dinâmico de hotéis e aluguéis.
Representação JSON |
---|
{ "propertyId": string, "propertyName": string, "imageUrl": string, "destinationName": string, "description": string, "price": string, "salePrice": string, "starRating": string, "category": string, "contextualKeywords": [ string ], "address": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "formattedPrice": string, "formattedSalePrice": string, "similarPropertyIds": [ string ] } |
Campos | |
---|---|
propertyId |
Obrigatório. O ID da propriedade, que pode ser qualquer sequência de letras e dígitos, precisa ser exclusivo e corresponder aos valores da tag de remarketing. Obrigatório. |
propertyName |
Obrigatório. Nome da propriedade, por exemplo, Hotel Mountain View. Obrigatório. |
imageUrl |
URL da imagem, por exemplo, http://www.example.com/image.png. A imagem não será enviada como recurso de imagem. |
destinationName |
Nome do destino, por exemplo, Downtown Mountain View. |
description |
Descrição, por exemplo, "Próximo ao aeroporto SJC". |
price |
Preço que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 100.00 USD. |
salePrice |
padrão ISO 4217. Use "." como separador decimal, por exemplo, 80.00 USD. Precisa ser menor que o campo "price". |
starRating |
Nota. Precisa ser um número entre 1 e 5. |
category |
"Categoria", por exemplo, "Pacote de hotel". |
contextualKeywords[] |
Palavras-chave contextuais, por exemplo, "Hotéis em Mountain View", hotéis em South Bay. |
address |
Endereço que pode ser especificado em um dos formatos a seguir. (1) Cidade, estado, código, país, por exemplo, Mountain View, CA, EUA. (2) Endereço completo, por exemplo, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude no formato DDD, por exemplo, 41.40338, 2.17403 |
androidAppLink |
Link direto do Android, por exemplo, android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Link direto do iOS, por exemplo, exampleApp://content/page. |
iosAppStoreId |
ID da App Store para iOS. É um número usado para verificar se o app está instalado no dispositivo antes de o usuário criar o link direto. Se este campo estiver definido, o campo iosAppLink também precisará estar presente. |
formattedPrice |
Preço formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "price", por exemplo, "A partir de US $100,00". |
formattedSalePrice |
Preço promocional formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "sale price", por exemplo, Em promoção por R $80,00. |
similarPropertyIds[] |
IDs de propriedades semelhantes |
DynamicFlightsAsset
Um recurso de voos dinâmicos.
Representação JSON |
---|
{ "destinationId": string, "originId": string, "flightDescription": string, "imageUrl": string, "destinationName": string, "originName": string, "flightPrice": string, "flightSalePrice": string, "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarDestinationIds": [ string ], "customMapping": string } |
Campos | |
---|---|
destinationId |
Obrigatório. O ID de destino, que pode ser qualquer sequência de letras e dígitos, precisa ser exclusivo e corresponder aos valores da tag de remarketing. Obrigatório. |
originId |
ID da origem, que pode ser qualquer sequência de letras e dígitos. A sequência de IDs (ID do destino + ID da origem) precisa ser exclusiva. |
flightDescription |
Obrigatório. Descrição do voo, por exemplo, "Reservar sua passagem". Obrigatório. |
imageUrl |
URL da imagem, por exemplo, http://www.example.com/image.png. A imagem não será enviada como recurso de imagem. |
destinationName |
Nome do destino, por exemplo, Paris. |
originName |
Nome da origem, por exemplo, Londres. |
flightPrice |
Preço do voo, que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 100.00 USD. |
flightSalePrice |
Preço promocional do voo, que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 80.00 USD. Precisa ser menor que o campo "flightPrice". |
formattedPrice |
Preço formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "price", por exemplo, "A partir de US $100,00". |
formattedSalePrice |
Preço promocional formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "sale price", por exemplo, Em promoção por R $80,00. |
androidAppLink |
Link direto do Android, por exemplo, android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Link direto do iOS, por exemplo, exampleApp://content/page. |
iosAppStoreId |
ID da App Store para iOS. É um número usado para verificar se o app está instalado no dispositivo antes de o usuário criar o link direto. Se este campo estiver definido, o campo iosAppLink também precisará estar presente. |
similarDestinationIds[] |
IDs de destinos semelhantes, por exemplo, PAR,LON. |
customMapping |
Um campo personalizado que pode ser o mapeamento de várias chaves para valores separados por delimitadores (",", "|" e ":"), na forma de " |
DiscoveryCarouselCardAsset
Um recurso do card de carrossel do Discovery.
Representação JSON |
---|
{ "marketingImageAsset": string, "squareMarketingImageAsset": string, "portraitMarketingImageAsset": string, "headline": string, "callToActionText": string } |
Campos | |
---|---|
marketingImageAsset |
Nome do recurso da imagem de marketing 1,91:1 associada. É obrigatório usar este recurso de imagem de marketing quadrada. |
squareMarketingImageAsset |
Nome do recurso da imagem de marketing quadrada associada. Este e/ou um recurso de imagem de marketing é obrigatório. |
portraitMarketingImageAsset |
Nome do recurso da imagem de marketing em modo retrato 4:5 associada. |
headline |
Obrigatório. Título do card do carrossel. |
callToActionText |
Texto de call-to-action. |
DynamicTravelAsset
Um recurso de viagem dinâmico.
Representação JSON |
---|
{ "destinationId": string, "originId": string, "title": string, "destinationName": string, "destinationAddress": string, "originName": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "category": string, "contextualKeywords": [ string ], "similarDestinationIds": [ string ], "imageUrl": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string } |
Campos | |
---|---|
destinationId |
Obrigatório. O ID de destino, que pode ser qualquer sequência de letras e dígitos, precisa ser exclusivo e corresponder aos valores da tag de remarketing. Obrigatório. |
originId |
ID da origem, que pode ser qualquer sequência de letras e dígitos. A sequência de IDs (ID do destino + ID da origem) precisa ser exclusiva. |
title |
Obrigatório. Título, por exemplo, "Reservar sua passagem de trem". Obrigatório. |
destinationName |
Nome do destino, por exemplo, Paris. |
destinationAddress |
Endereço de destino que pode ser especificado em um dos formatos a seguir. (1) Cidade, estado, código, país, por exemplo, Mountain View, CA, EUA. (2) Endereço completo, por exemplo, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude no formato DDD, por exemplo, 41.40338, 2.17403. |
originName |
Nome da origem, por exemplo, Londres. |
price |
Preço que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 100.00 USD. |
salePrice |
Preço promocional que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 80.00 USD. Precisa ser menor que o campo "price". |
formattedPrice |
Preço formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "price", por exemplo, "A partir de US $100,00". |
formattedSalePrice |
Preço promocional formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "sale price", por exemplo, Em promoção por R $80,00. |
category |
"Categoria", por exemplo, "Expresso". |
contextualKeywords[] |
Palavras-chave contextuais, como "trens de Paris". |
similarDestinationIds[] |
IDs de destinos semelhantes, por exemplo, Nova York. |
imageUrl |
URL da imagem, por exemplo, http://www.example.com/image.png. A imagem não será enviada como recurso de imagem. |
androidAppLink |
Link direto do Android, por exemplo, android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Link direto do iOS, por exemplo, exampleApp://content/page. |
iosAppStoreId |
ID da App Store para iOS. É um número usado para verificar se o app está instalado no dispositivo antes de o usuário criar o link direto. Se este campo estiver definido, o campo iosAppLink também precisará estar presente. |
DynamicLocalAsset
Um recurso local dinâmico.
Representação JSON |
---|
{ "dealId": string, "dealName": string, "subtitle": string, "description": string, "price": string, "salePrice": string, "imageUrl": string, "address": string, "category": string, "contextualKeywords": [ string ], "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "similarDealIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
Campos | |
---|---|
dealId |
Obrigatório. O ID da transação, que pode ser qualquer sequência de letras e dígitos, precisa ser exclusivo e corresponder aos valores da tag de remarketing. Obrigatório. |
dealName |
Obrigatório. Nome da oferta, por exemplo, 50% de desconto na Mountain View Grocers. Obrigatório. |
subtitle |
Subtítulo, por exemplo, Supermercados. |
description |
Descrição, por exemplo, "Economize na fatura semanal". |
price |
Preço que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 100.00 USD. |
salePrice |
Preço promocional que pode ser um número seguido pelo código alfabético da moeda no padrão ISO 4217. Use "." como separador decimal, por exemplo, 80.00 USD. Precisa ser menor que o campo "price". |
imageUrl |
URL da imagem, por exemplo, http://www.example.com/image.png. A imagem não será enviada como recurso de imagem. |
address |
Endereço que pode ser especificado em um dos formatos a seguir. (1) Cidade, estado, código, país, por exemplo, Mountain View, CA, EUA. (2) Endereço completo, por exemplo, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude no formato DDD, por exemplo, 41.40338, 2.17403. |
category |
"Categoria", por exemplo, "Comida". |
contextualKeywords[] |
Palavras-chave contextuais, por exemplo, "Salvar cupons de supermercado". |
formattedPrice |
Preço formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "price", por exemplo, "A partir de US $100,00". |
formattedSalePrice |
Preço promocional formatado, que pode ser qualquer caractere. Se definido, o atributo será usado no lugar de "sale price", por exemplo, Em promoção por R $80,00. |
androidAppLink |
Link direto do Android, por exemplo, android-app://com.example.android/http/example.com/gizmos?1234. |
similarDealIds[] |
IDs de transação semelhantes, por exemplo, 1275. |
iosAppLink |
Link direto do iOS, por exemplo, exampleApp://content/page. |
iosAppStoreId |
ID da App Store para iOS. É um número usado para verificar se o app está instalado no dispositivo antes de o usuário criar o link direto. Se este campo estiver definido, o campo iosAppLink também precisará estar presente. |
DynamicJobsAsset
Um recurso de vagas dinâmicas.
Representação JSON |
---|
{ "jobId": string, "locationId": string, "jobTitle": string, "jobSubtitle": string, "description": string, "imageUrl": string, "jobCategory": string, "contextualKeywords": [ string ], "address": string, "salary": string, "androidAppLink": string, "similarJobIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
Campos | |
---|---|
jobId |
Obrigatório. O ID da vaga, que pode ser qualquer sequência de letras e dígitos, precisa ser exclusivo e corresponder aos valores da tag de remarketing. Obrigatório. |
locationId |
ID do local, que pode ser qualquer sequência de letras e dígitos. A sequência de códigos (ID do job + código do local) precisa ser exclusiva. |
jobTitle |
Obrigatório. Cargo, por exemplo, engenheiro de software. Obrigatório. |
jobSubtitle |
Subtítulo do cargo, por exemplo, Nível II. |
description |
Uma descrição, por exemplo, "Aplicar suas habilidades técnicas". |
imageUrl |
URL da imagem, por exemplo, http://www.example.com/image.png. A imagem não será enviada como recurso de imagem. |
jobCategory |
Categoria do trabalho, por exemplo, "Técnico". |
contextualKeywords[] |
Palavras-chave contextuais, por exemplo, "trabalho de engenharia de software". |
address |
Endereço que pode ser especificado em um dos formatos a seguir. (1) Cidade, estado, código, país, por exemplo, Mountain View, CA, EUA. (2) Endereço completo, por exemplo, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude no formato DDD, por exemplo, 41.40338, 2.17403. |
salary |
Salário, por exemplo, US$ 100.000. |
androidAppLink |
Link direto do Android, por exemplo, android-app://com.example.android/http/example.com/gizmos?1234. |
similarJobIds[] |
IDs de cargos semelhantes, por exemplo, 1275. |
iosAppLink |
Link direto do iOS, por exemplo, exampleApp://content/page. |
iosAppStoreId |
ID da App Store para iOS. É um número usado para verificar se o app está instalado no dispositivo antes de o usuário criar o link direto. Se este campo estiver definido, o campo iosAppLink também precisará estar presente. |
LocationAsset
Um recurso de local.
Representação JSON |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
Campos | |
---|---|
placeId |
IDs de lugares identificam um local de modo exclusivo no banco de dados do Google Places e no Google Maps. Esse campo é exclusivo para um determinado ID de cliente e tipo de recurso. Consulte https://developers.google.com/places/web-service/place-id para saber mais sobre o ID de lugar. |
businessProfileLocations[] |
A lista de locais da empresa do cliente. Isso só será retornado se o recurso de local estiver sendo sincronizado da conta do Perfil da Empresa. É possível ter várias fichas de empresas do Perfil da Empresa na mesma conta que apontam para o mesmo ID de lugar. |
locationOwnershipType |
O tipo de propriedade de local. Se o tipo for BUSINESS_OWNER, ele será exibido como uma extensão de local. Se o tipo for AFILIADO, ele será exibido como um local de afiliado. |
BusinessProfileLocation
Os dados de local do Perfil da Empresa foram sincronizados da conta vinculada do Perfil da Empresa.
Representação JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Campos | |
---|---|
labels[] |
Rótulo especificado pelo anunciante para o local na conta do Perfil da Empresa. Isso é sincronizado na conta do Perfil da Empresa. |
storeCode |
É o código da loja do Perfil da Empresa desse local. Isso é sincronizado na conta do Perfil da Empresa. |
listingId |
ID da ficha desse local do Perfil da Empresa. Isso é sincronizado na conta vinculada do Perfil da Empresa. |
HotelPropertyAsset
Um recurso de propriedade do hotel.
Representação JSON |
---|
{ "placeId": string, "hotelAddress": string, "hotelName": string } |
Campos | |
---|---|
placeId |
IDs de lugares identificam um local de modo exclusivo no banco de dados do Google Places e no Google Maps. Consulte https://developers.google.com/places/web-service/place-id para saber mais. |
hotelAddress |
Endereço do hotel. Somente leitura. |
hotelName |
Nome do hotel. Somente leitura. |