ExtensionFeedItem

Um item do 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 de tempo 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 do feed. Somente leitura.
startDateTime

string

Horário de início em que o item do feed está em vigor e pode começar a ser veiculado. A hora 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 esse item do feed não está mais disponível e vai deixar de ser veiculado. A hora 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 da segmentação por área 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 do feed que segmentam uma campanha ou 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. Esta 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 ficar vazia e seu tamanho 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 aos 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 um 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, com duas letras maiúsculas, do número de telefone do anunciante. Este campo é obrigatório.
phoneNumber

string

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

string

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

string

O extensionText da 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)

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 do idioma usado para essa extensão de preço.
finalUrlSuffix

string

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

PriceOffer

Representa uma oferta de 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 da 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 que a promoção segmenta. Este campo é obrigatório.
promotionStartDate

string

Data de início do momento em que a promoção se qualifica para ser resgatada.
promotionEndDate

string

Última data em que a promoção se qualifica para ser resgatada.
trackingUrlTemplate

string

Modelo de URL para criar um URL de rastreamento.
finalUrlSuffix

string

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

string

Idioma da promoção. Representado como tag de idioma BCP 47.
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

string (int64 format)

Porcentagem de desconto na promoção, em micros. Um milhão é equivalente a um por cento. É obrigatório usar este valor ou o value_off_amount.
moneyAmountOff

object (Money)

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

string

Um 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)

ID da rede de varejo que é anunciada como um 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

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

ImageFeedItem

Representa a extensão de imagem fornecida por um anunciante.

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

string

Obrigatório. Nome do recurso de imagem.