ExtensionFeedItem

Un elemento del feed de extensiones

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 extensiones. Los nombres de los recursos de los elementos del feed de la extensión tienen el siguiente formato:

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

enum (ExtensionType)

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

object (AdScheduleInfo)

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

enum (FeedItemTargetDevice)

Es el dispositivo de destino.
targetedKeyword

object (KeywordInfo)

La palabra clave de segmentación
status

enum (FeedItemStatus)

Solo salida. Es el estado del elemento de 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 entra en vigencia y puede comenzar a publicarse. La hora está 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 dejará de funcionar y dejará de publicarse. La hora está 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

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 el Perfil de Negocio a un feed. Este campo es de solo lectura.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Solo salida. Extensión de ubicación afiliada. Google Ads propaga las ubicaciones del feed según 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. Orientación a nivel de la campaña o del grupo de anuncios Los elementos del feed segmentados para 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 de segmentación
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

Son los valores del fragmento. El tamaño máximo de esta colección es 10.
header

string

Es el encabezado del fragmento. Esta cadena no debe 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)

El almacén de aplicaciones al que pertenece la aplicación objetivo. 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 multidominio.
urlCustomParameters[]

object (CustomParameter)

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

string

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

string

El ID específico de la tienda para la aplicación objetivo. Esta cadena no debe 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 seguimiento paralelo.

AppStore

Tipo de tienda de aplicaciones en una extensión de aplicación.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión.
APPLE_ITUNES iTunes de Apple.
GOOGLE_PLAY 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

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

Calificador de precio para todas las ofertas de esta extensión de precios.
priceOfferings[]

object (PriceOffer)

Son 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 utilizado 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 de precio de esta oferta.
unit

enum (PriceExtensionPriceUnit)

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 multidominio.
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 para la que se creó la promoción. Si se establece una ocasión, la ventana de canje deberá estar dentro del período asociado a 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 multidominio.
urlCustomParameters[]

object (CustomParameter)

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

string

Es una descripción en 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 seguimiento paralelo.
languageCode

string

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

string (int64 format)

Porcentaje de descuento de la promoción en micros. Un millón equivale a un uno por ciento. Es obligatorio indicar este importe o el importe de pay_off_amount.
moneyAmountOff

object (Money)

Importe de descuento para la promoción. Es obligatorio indicar uno de estos dos valores o "percentOff".
Campo de unión promotion_trigger. Activador de la promoción. Puede ser por código promocional o promoción por importe del pedido apto. Las direcciones (promotion_trigger) solo pueden ser una de las siguientes opciones:
promotionCode

string

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

object (Money)

Es el importe total del pedido que debe corresponder al usuario para poder acceder a 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

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

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

Nombre de la cadena.

HotelCalloutFeedItem

Representa una extensión de texto destacado de hoteles.

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

string

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

string

Es el idioma del texto destacado de hoteles. Es un código de idioma que cumple con el estándar IETF BCP 47.

ImageFeedItem

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

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

string

Obligatorio. Nombre del recurso de imagen.