ExtensionFeedItem

Un elemento del feed de una extensión.

Representación 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

Inmutable. El nombre del recurso del elemento del feed de la extensión. Los nombres de los recursos del elemento del feed de la extensión tienen el siguiente formato:

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

enum (ExtensionType)

Solo salida. El tipo de extensión del elemento del feed de extensiones. Este campo es de solo lectura.
adSchedules[]

object (AdScheduleInfo)

Lista de programaciones no superpuestas que especifican todos los intervalos de tiempo en los que se puede publicar el elemento del feed. Puede haber un máximo de 6 programas por día.
device

enum (FeedItemTargetDevice)

El dispositivo de destino
targetedKeyword

object (KeywordInfo)

Es la palabra clave de segmentación.
status

enum (FeedItemStatus)

Solo salida. Estado del elemento del feed. Este campo es de solo lectura.
id

string (int64 format)

Solo salida. El ID de este elemento del feed. Solo lectura.
startDateTime

string

Es la hora de inicio en la que este elemento del feed está en vigencia y puede comenzar a publicarse. La hora se encuentra en la zona horaria del cliente. El formato es "AAAA-MM-DD HH:MM:SS". Ejemplos: "2018-03-05 09:15:00" o "2018-02-01 14:34:30"
endDateTime

string

Es la hora de finalización en la que este elemento del feed ya no tiene vigencia y dejará de publicarse. La hora se encuentra en la zona horaria del cliente. El formato es "AAAA-MM-DD HH:MM:SS". Ejemplos: "2018-03-05 09:15:00" o "2018-02-01 14:34:30"
targetedGeoTargetConstant

string

Es la constante de segmentación geográfica de segmentación.
Campo de unión extension. Tipo de extensión. Las direcciones (extension) solo pueden ser una de las siguientes opciones:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Extensión de fragmento estructurado.
appFeedItem

object (AppFeedItem)

Extensión de aplicación.
callFeedItem

object (CallFeedItem)

Extensión de llamada.
calloutFeedItem

object (CalloutFeedItem)

Extensión de texto destacado.
textMessageFeedItem

object (TextMessageFeedItem)

Extensión de mensaje de texto
priceFeedItem

object (PriceFeedItem)

Extensión de precios.
promotionFeedItem

object (PromotionFeedItem)

Extensión de promoción.
locationFeedItem

object (LocationFeedItem)

Solo salida. Extensión de ubicación. Las ubicaciones se sincronizan desde un Perfil de Negocio en un feed. Este campo es de solo lectura.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Solo salida. Extensión de ubicación afiliada. Google Ads propaga las ubicaciones de los feeds en función de un ID de cadena. Este campo es de solo lectura.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Extensión de texto destacado de hoteles.
imageFeedItem

object (ImageFeedItem)

Inmutable. Extensión de imagen proporcionada por el anunciante.
Campo de unión serving_resource_targeting. La segmentación se aplica a nivel de la campaña o del grupo de anuncios. Los elementos del feed que se orienten a una campaña o un grupo de anuncios solo se publicarán con ese recurso. Las direcciones (serving_resource_targeting) solo pueden ser una de las siguientes opciones:
targetedCampaign

string

La campaña segmentada
targetedAdGroup

string

El grupo de anuncios orientado.

StructuredSnippetFeedItem

Representa una extensión de fragmento estructurado.

Representación JSON 
{
  "values": [
    string
  ],
  "header": string
}
Campos
values[]

string

Los valores en el fragmento. El tamaño máximo de esta colección es 10.
header

string

Es el encabezado del fragmento. Esta cadena no puede estar vacía.

AppFeedItem

Representa una extensión de aplicación.

Representación JSON 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
Campos
appStore

enum (AppStore)

La tienda de aplicaciones a la que pertenece la aplicación de destino. Este campo es obligatorio.
finalUrls[]

string

Una lista de las posibles URLs finales después de todos los redireccionamientos entre dominios. Esta lista no debe estar vacía.
finalMobileUrls[]

string

Una lista de posibles URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios
urlCustomParameters[]

object (CustomParameter)

Una lista de asignaciones que se usarán para sustituir las etiquetas de parámetros personalizados de URL en trackingUrlTemplate, finalUrls o finalMobileUrls.
linkText

string

Es el texto visible que se muestra cuando el vínculo se renderiza en un anuncio. Esta cadena no debe estar vacía, y su longitud debe estar entre 1 y 25, inclusive.
appId

string

Es el ID específico de la tienda para la aplicación de destino. Esta cadena no puede estar vacía.
trackingUrlTemplate

string

Plantilla de URL para crear una URL de seguimiento. El valor predeterminado es “{lpurl}”.
finalUrlSuffix

string

Plantilla de URL para agregar parámetros a las URLs de páginas de destino publicadas con el seguimiento paralelo.

AppStore

Es el tipo de tienda de aplicaciones en una extensión de aplicación.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
APPLE_ITUNES iTunes de Apple
GOOGLE_PLAY Mediante el uso de Google Play

TextMessageFeedItem

Es una extensión en la que los usuarios pueden hacer clic para enviar un mensaje de texto al anunciante.

Representación JSON 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Campos
businessName

string

El nombre de la empresa que se debe anteponer al texto del mensaje. Este campo es obligatorio.
countryCode

string

Escribe el código de país de dos letras en mayúsculas del número de teléfono del anunciante. Este campo es obligatorio.
phoneNumber

string

Es el número de teléfono del anunciante al que se enviará el mensaje. Obligatorio.
text

string

El texto que se mostrará en el anuncio. Este campo es obligatorio.
extensionText

string

El mensaje extensionText propagado en la app de mensajería

PriceFeedItem

Representa una extensión de precios.

Representación JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
Campos
type

enum (PriceExtensionType)

Es el tipo de extensión de precios de esta extensión.
priceQualifier

enum (PriceExtensionPriceQualifier)

Es un calificador de precio para todas las ofertas de esta extensión de precios.
priceOfferings[]

object (PriceOffer)

Las ofertas de precios de esta extensión de precios.
trackingUrlTemplate

string

Plantilla de URL de seguimiento para todas las ofertas de esta extensión de precios.
languageCode

string

Es el código del idioma que se usa para esta extensión de precios.
finalUrlSuffix

string

Plantilla de URL de seguimiento para todas las ofertas de esta extensión de precios.

PriceOffer

Representa una oferta de precio en una extensión de precios.

Representación JSON 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
Campos
price

object (Money)

Es el valor del precio de esta oferta.
unit

enum (PriceExtensionPriceUnit)

Es la unidad de precio de esta oferta.
finalUrls[]

string

Una lista de las posibles URLs finales después de todos los redireccionamientos entre dominios.
finalMobileUrls[]

string

Una lista de posibles URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios
header

string

Texto del encabezado de esta oferta.
description

string

Texto descriptivo de esta oferta.

PromotionFeedItem

Representa una extensión de promoción.

Representación 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)

Enumeración que modifica la calificación del descuento.
occasion

enum (PromotionExtensionOccasion)

La ocasión a la que estaba destinada la promoción. Si se configura una ocasión, el período de canje deberá encontrarse dentro del período asociado con la ocasión.
finalUrls[]

string

Una lista de las posibles URLs finales después de todos los redireccionamientos entre dominios. Este campo es obligatorio.
finalMobileUrls[]

string

Una lista de posibles URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios
urlCustomParameters[]

object (CustomParameter)

Una lista de asignaciones que se usarán para sustituir las etiquetas de parámetros personalizados de URL en trackingUrlTemplate, finalUrls o finalMobileUrls.
promotionTarget

string

Una descripción de formato libre de a qué se orienta la promoción. Este campo es obligatorio.
promotionStartDate

string

Es la fecha de inicio en la que se puede canjear la promoción.
promotionEndDate

string

Es la última fecha en la que se puede canjear la promoción.
trackingUrlTemplate

string

Plantilla de URL para crear una URL de seguimiento.
finalUrlSuffix

string

Plantilla de URL para agregar parámetros a las URLs de páginas de destino publicadas con el seguimiento paralelo.
languageCode

string

Es el idioma de la promoción. Se representa como etiqueta de idioma BCP 47.
Campo de unión discount_type. El tipo de descuento puede ser un porcentaje de descuento o descuento. discount_type solo puede ser una de las siguientes opciones:
percentOff

string (int64 format)

Porcentaje de descuento en la promoción en micros. Un millón equivale a un uno por ciento. Se requiere este valor o currency_off_amount.
moneyAmountOff

object (Money)

Importe de descuento por descuento en la promoción. Se requiere este valor o %Off.
Campo de unión promotion_trigger. Activador de promoción. Puede ser por código promocional o promocional según el importe del pedido apto. Las direcciones (promotion_trigger) solo pueden ser una de las siguientes opciones:
promotionCode

string

Es un código que el usuario debe usar a fin de ser apto para la promoción.
ordersOverAmount

object (Money)

El importe total del pedido a fin de que el usuario sea apto para la promoción.

LocationFeedItem

Representa una extensión de ubicación.

Representación JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Campos
businessName

string

Corresponde al nombre de la empresa.
addressLine1

string

Línea 1 de la dirección de la empresa
addressLine2

string

Línea 2 de la dirección de la empresa
city

string

Ciudad de la dirección de la empresa.
province

string

Indica la provincia de la dirección de la empresa.
postalCode

string

Es el código postal de la dirección de la empresa.
countryCode

string

Es el código de país de la dirección de la empresa.
phoneNumber

string

Es el número de teléfono de la empresa.

AffiliateLocationFeedItem

Representa una extensión de ubicación afiliada.

Representación JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Campos
businessName

string

Corresponde al nombre de la empresa.
addressLine1

string

Línea 1 de la dirección de la empresa
addressLine2

string

Línea 2 de la dirección de la empresa
city

string

Ciudad de la dirección de la empresa.
province

string

Indica la provincia de la dirección de la empresa.
postalCode

string

Es el código postal de la dirección de la empresa.
countryCode

string

Es el código de país de la dirección de la empresa.
phoneNumber

string

Es el número de teléfono de la empresa.
chainId

string (int64 format)

Es el ID de la cadena de venta minorista que se anuncia como vendedor de tu producto.
chainName

string

Es el nombre de la cadena.

HotelCalloutFeedItem

Representa una extensión de texto destacado de hoteles.

Representación JSON 
{
  "text": string,
  "languageCode": string
}
Campos
text

string

El texto destacado La longitud de esta cadena debe ser entre 1 y 25, inclusive.
languageCode

string

El idioma del texto destacado de hoteles. Código de idioma que cumple con la norma IETF BCP 47.

ImageFeedItem

Representa una extensión de imagen que proporciona el anunciante.

Representación JSON 
{
  "imageAsset": string
}
Campos
imageAsset

string

Obligatorio. Es el nombre del recurso de imagen.