ExtensionFeedItem

Un elemento del feed de 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 de los elementos 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 la extensión. 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 programaciones por día.

device

enum (FeedItemTargetDevice)

El dispositivo de destino.

targetedKeyword

object (KeywordInfo)

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 entra 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 es efectivo y deja 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 del feed 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. Orientación 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 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

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

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.

appId

string

El ID específico de la tienda para la aplicación de destino. 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ágina de destino que se publican con el seguimiento paralelo.

AppStore

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

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. 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

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

countryCode

string

Escribir en mayúsculas el código de país de dos letras 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)

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

Unidad de precio para 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)

Es una 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, 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 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

Ú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ágina de destino que se publican con el seguimiento paralelo.

languageCode

string

Se refiere al idioma de la promoción. Se representa como una etiqueta de idioma BCP 47.

Campo de unión discount_type. El tipo de descuento puede ser un porcentaje de descuento o un descuento del importe. 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)

Es el importe de descuento por el 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 promoción, 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 para ser apto para la promoción.

ordersOverAmount

object (Money)

El importe total del pedido debe ser 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

Provincia de la dirección de la empresa

postalCode

string

Código postal de la dirección de la empresa

countryCode

string

Código de país de la dirección de la empresa.

phoneNumber

string

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

Código postal de la dirección de la empresa

countryCode

string

Código de país de la dirección de la empresa.

phoneNumber

string

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 proporcionada por el anunciante.

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

string

Obligatorio. Es el nombre del recurso del recurso de imagen.