ExtensionFeedItem

Um item de feed de extensão.

Representação JSON 
{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}
Campos
resourceName

string

Imutável. O nome do recurso do item do feed da extensão. Os nomes dos recursos de itens do feed da extensão têm o seguinte formato:

customers/{customerId}/extensionFeedItems/{feed_item_id}
extensionType

enum (ExtensionType)

Apenas saída. O tipo de extensão do item do feed de extensões. Este campo é somente leitura.
adSchedules[]

object (AdScheduleInfo)

Lista de programações não sobrepostas que especificam todos os intervalos em que o item do feed pode ser veiculado. Pode haver no máximo seis programações por dia.
device

enum (FeedItemTargetDevice)

O dispositivo segmentado.
targetedKeyword

object (KeywordInfo)

A palavra-chave segmentada.
status

enum (FeedItemStatus)

Apenas saída. Status do item do feed. Este campo é somente leitura.
id

string (int64 format)

Apenas saída. O ID desse item de feed. Somente leitura.
startDateTime

string

Horário de início em que esse item do feed está em vigor e pode começar a ser veiculado. O horário está no fuso horário do cliente. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
endDateTime

string

Horário de término em que este item do feed não é mais eficaz e deixará de ser veiculado. O horário está no fuso horário do cliente. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
targetedGeoTargetConstant

string

A constante de segmentação geográfica segmentada.
Campo de união extension. Tipo de extensão. extension pode ser apenas de um dos tipos a seguir:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Extensão de snippets estruturados.
appFeedItem

object (AppFeedItem)

Extensão de aplicativo.
callFeedItem

object (CallFeedItem)

Extensão de chamada.
calloutFeedItem

object (CalloutFeedItem)

Extensão de frase de destaque.
textMessageFeedItem

object (TextMessageFeedItem)

Extensão de mensagem de texto.
priceFeedItem

object (PriceFeedItem)

Extensão de preço.
promotionFeedItem

object (PromotionFeedItem)

Extensão de promoção.
locationFeedItem

object (LocationFeedItem)

Apenas saída. Extensão de local. Os locais são sincronizados do Perfil da Empresa para um feed. Este campo é somente leitura.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Apenas saída. Extensão de local de afiliados. Os locais do feed são preenchidos pelo Google Ads com base em um código da rede. Este campo é somente leitura.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Extensão de frase de destaque de hotel.
imageFeedItem

object (ImageFeedItem)

Imutável. Extensão de imagem fornecida pelo anunciante.
Campo de união serving_resource_targeting. Segmentação no nível da campanha ou do grupo de anúncios. Os itens de feed que segmentam uma campanha ou um grupo de anúncios só serão veiculados com esse recurso. serving_resource_targeting pode ser apenas de um dos tipos a seguir:
targetedCampaign

string

A campanha segmentada.
targetedAdGroup

string

O grupo de anúncios segmentado.

StructuredSnippetFeedItem

Representa uma extensão de snippets estruturados.

Representação JSON 
{
  "values": [
    string
  ],
  "header": string
}
Campos
values[]

string

Os valores no snippet. O tamanho máximo desta coleção é 10.
header

string

Cabeçalho do snippet. Esta string não pode ficar em branco.

AppFeedItem

Representa uma extensão de aplicativo.

Representação JSON 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
Campos
appStore

enum (AppStore)

A loja de aplicativos à qual o aplicativo de destino pertence. Este campo é obrigatório.
finalUrls[]

string

Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios. Essa lista não pode ficar vazia.
finalMobileUrls[]

string

Uma lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios.
urlCustomParameters[]

object (CustomParameter)

Uma lista de mapeamentos a serem usados para substituir tags de parâmetros personalizados de URL no TrackingUrlTemplate, finalUrls e/ou finalMobileUrls.
linkText

string

O texto visível exibido quando o link é renderizado em um anúncio. Essa string não pode estar vazia e seu comprimento deve estar entre 1 e 25, inclusive.
appId

string

O ID específico da loja para o aplicativo de destino. Esta string não pode ficar em branco.
trackingUrlTemplate

string

Modelo de URL para criar um URL de rastreamento. O valor padrão é "{lpurl}".
finalUrlSuffix

string

Modelo de URL para anexar parâmetros a URLs da página de destino veiculados com acompanhamento paralelo.

AppStore

Tipo de app store em uma extensão de aplicativo.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
APPLE_ITUNES iTunes da Apple
GOOGLE_PLAY Google Play

TextMessageFeedItem

Uma extensão na qual os usuários podem clicar para enviar uma mensagem de texto ao anunciante.

Representação JSON 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Campos
businessName

string

O nome da empresa a ser anexado ao texto da mensagem. Este campo é obrigatório.
countryCode

string

Código do país de duas letras maiúsculo do número de telefone do anunciante. Este campo é obrigatório.
phoneNumber

string

O número de telefone do anunciante para o qual a mensagem será enviada. Obrigatório.
text

string

O texto a ser exibido no anúncio. Este campo é obrigatório.
extensionText

string

O texto da extensão de mensagem preenchido no app de mensagens.

PriceFeedItem

Representa uma extensão de preço.

Representação JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
Campos
type

enum (PriceExtensionType)

É o tipo de extensão de preço desta extensão.
priceQualifier

enum (PriceExtensionPriceQualifier)

Qualificador de preço para todas as ofertas desta extensão de preço.
priceOfferings[]

object (PriceOffer)

As ofertas de preço nessa extensão de preço.
trackingUrlTemplate

string

Modelo de URL de rastreamento para todas as ofertas desta extensão de preço.
languageCode

string

O código da linguagem usada para esta extensão de preço.
finalUrlSuffix

string

Modelo de URL de rastreamento para todas as ofertas desta extensão de preço.

PriceOffer

Representa um preço em uma extensão de preço.

Representação JSON 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
Campos
price

object (Money)

Valor do preço desta oferta.
unit

enum (PriceExtensionPriceUnit)

Unidade de preço desta oferta.
finalUrls[]

string

Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios.
finalMobileUrls[]

string

Uma lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios.
header

string

Texto do cabeçalho desta oferta.
description

string

Texto de descrição desta oferta.

PromotionFeedItem

Representa uma extensão de promoção.

Representação JSON 
{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
Campos
discountModifier

enum (PromotionExtensionDiscountModifier)

Enumeração que modifica a qualificação do desconto.
occasion

enum (PromotionExtensionOccasion)

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.
finalUrls[]

string

Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios. Este campo é obrigatório.
finalMobileUrls[]

string

Uma lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos entre domínios.
urlCustomParameters[]

object (CustomParameter)

Uma lista de mapeamentos a serem usados para substituir tags de parâmetros personalizados de URL no TrackingUrlTemplate, finalUrls e/ou finalMobileUrls.
promotionTarget

string

Uma descrição livre do direcionamento da promoção. Este campo é obrigatório.
promotionStartDate

string

Data de início do resgate da promoção.
promotionEndDate

string

Última data em que a promoção pode ser resgatada.
trackingUrlTemplate

string

Modelo de URL para criar um URL de rastreamento.
finalUrlSuffix

string

Modelo de URL para anexar parâmetros a URLs da página de destino veiculados com acompanhamento paralelo.
languageCode

string

Idioma da promoção. Representada como tag de idioma BCP 47.
Campo de união discount_type. O tipo de desconto pode ser uma porcentagem ou um valor de desconto. discount_type só pode ser uma das seguintes opções:
percentOff

string (int64 format)

Desconto percentual da promoção em micros. Um milhão é equivalente a 1%. É obrigatório usar "This" ou "money_off_amount".
moneyAmountOff

object (Money)

Valor do desconto na promoção. É obrigatório fazer isso ou percentOff.
Campo de união promotion_trigger. Acionador de 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

string

É o código que o usuário deve usar para se qualificar para a promoção.
ordersOverAmount

object (Money)

É o valor total do pedido para que o usuário se qualifique para a promoção.

LocationFeedItem

Representa uma extensão de local.

Representação JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Campos
businessName

string

É o nome da empresa.
addressLine1

string

Linha 1 do endereço comercial.
addressLine2

string

Linha 2 do endereço comercial.
city

string

Cidade do endereço comercial.
province

string

Província do endereço comercial.
postalCode

string

CEP do endereço da empresa.
countryCode

string

Código do país do endereço da empresa.
phoneNumber

string

Número de telefone da empresa.

AffiliateLocationFeedItem

Representa uma extensão de local de afiliado.

Representação JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Campos
businessName

string

É o nome da empresa.
addressLine1

string

Linha 1 do endereço comercial.
addressLine2

string

Linha 2 do endereço comercial.
city

string

Cidade do endereço comercial.
province

string

Província do endereço comercial.
postalCode

string

CEP do endereço da empresa.
countryCode

string

Código do país do endereço da empresa.
phoneNumber

string

Número de telefone da empresa.
chainId

string (int64 format)

É o ID da rede de varejo anunciada como vendedor do seu produto.
chainName

string

Nome da rede.

HotelCalloutFeedItem

Representa uma extensão de frase de destaque de hotel.

Representação JSON 
{
  "text": string,
  "languageCode": string
}
Campos
text

string

O texto da frase de destaque. Esta string conter entre 1 e 25 caracteres (valores inclusivos).
languageCode

string

O idioma do texto da frase de destaque do hotel. Código de idioma compatível com IETF BCP 47.

ImageFeedItem

Representa uma extensão de imagem fornecida pelo anunciante.

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

string

Obrigatório. Nome do recurso de imagem.