- Representación JSON
- Cuota
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- Envío
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- Impuestos
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- Certificación
- ProductStructuredTitle
- ProductStructuredDescription
Atributos
Representación JSON |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "gtin": [ string ], "price": { object ( |
Campos | |
---|---|
additional |
Son las URLs adicionales de las imágenes del artículo. |
expiration |
Es la fecha en la que el artículo debe vencer, como se especifica cuando se inserta, en formato ISO 8601. La fecha de vencimiento real se expone en |
disclosure |
Es la fecha y hora en la que una oferta se hace visible en los resultados de la búsqueda de las plataformas de YouTube de Google, en formato ISO 8601. Consulta [Fecha de divulgación]( https://support.google.com/merchants/answer/13034208) para obtener más información. |
availability |
Es el día en que un producto pedido por adelantado está disponible para su entrega, en formato ISO 8601. |
gtin[] |
Códigos comerciales globales de artículo (GTIN) del artículo Puedes proporcionar hasta 10 GTIN. |
price |
Precio del artículo. |
installment |
Es la cantidad y el importe de las cuotas para pagar un artículo. |
subscription |
Es la cantidad de períodos (meses o años) y el importe del pago por período de un artículo con un contrato de suscripción asociado. |
loyalty |
Son los puntos de lealtad que los usuarios reciben después de comprar el artículo. Solo en Japón. |
loyalty |
Es una lista de información del programa de lealtad que se usa para mostrar los beneficios de lealtad (por ejemplo, mejores precios, puntos, etcétera) al usuario de este artículo. |
product |
Son las categorías del artículo (con el formato que se indica en las especificaciones de datos de productos). |
sale |
Es el precio de oferta publicado del artículo. |
sale |
Es el período durante el cual el artículo está en oferta (consulta las especificaciones de datos de productos). |
product |
Es la altura del producto en las unidades proporcionadas. El valor debe estar entre 0 (excluido) y 3,000 (incluido). |
product |
Es la longitud del producto en las unidades proporcionadas. El valor debe estar entre 0 (excluido) y 3,000 (incluido). |
product |
Es el ancho del producto en las unidades proporcionadas. El valor debe estar entre 0 (excluido) y 3,000 (incluido). |
product |
Es el peso del producto en las unidades proporcionadas. El valor debe estar entre 0 (excluido) y 2,000 (incluido). |
shipping[] |
Reglas de envío |
free |
Condiciones que se deben cumplir para que un producto tenga envío gratis. |
shipping |
Es el peso del artículo para el envío. |
shipping |
Es la longitud del artículo para el envío. |
shipping |
Es el ancho del artículo para el envío. |
shipping |
Es la altura del artículo para el envío. |
size |
Es el corte del artículo. Se puede usar para representar tipos de tallas combinadas para artículos de ropa. Se pueden proporcionar dos tipos de tallas como máximo (consulta [https://support.google.com/merchants/answer/6324497](tipo de talla)). |
taxes[] |
Información fiscal |
unit |
La medida y la dimensión de un artículo. |
unit |
Es la preferencia del denominador del precio unitario. |
ads |
Es similar a adsGrouping, pero solo funciona en CPC. |
cost |
Costo de bienes vendidos. Se usa para los informes de ganancias brutas. |
product |
Especificaciones técnicas o detalles adicionales del producto |
product |
Son viñetas que describen los aspectos más destacados de un producto. |
display |
Son recomendaciones especificadas por el anunciante. |
promotion |
Es el ID único de una promoción. |
included |
Es la lista de destinos que se incluirán en este destino (corresponde a las casillas de verificación marcadas en Merchant Center). Los destinos predeterminados siempre se incluyen, a menos que se proporcionen en |
excluded |
Es la lista de destinos que se excluirán de esta segmentación (corresponde a las casillas de verificación que no se marcaron en Merchant Center). |
shopping |
Es una lista de códigos de país (ISO 3166-1 alpha-2) para excluir la oferta del destino de los anuncios de Shopping. Los países de esta lista se quitan de los países configurados en la configuración de la fuente de datos. |
lifestyle |
Son URLs adicionales de imágenes de estilo de vida del artículo que se usan para identificar de forma explícita las imágenes que muestran tu artículo en un contexto real. Consulta el artículo del Centro de ayuda para obtener más información. |
cloud |
Campos adicionales para exportar al programa de Cloud para venta minorista. |
certifications[] |
Certificaciones de productos, por ejemplo, para el etiquetado de eficiencia energética de los productos registrados en la base de datos del EPREL de la UE Consulta el artículo del Centro de ayuda para obtener más información. |
auto |
Una protección en los proyectos "Descuentos automatizados" (https://support.google.com/merchants/answer/10295759) y "Promociones dinámicas" (https://support.google.com/merchants/answer/13949249) que garantiza que los descuentos en las ofertas de los comercios no disminuyan por debajo de este valor, lo que preserva el valor y la rentabilidad de la oferta. |
identifier |
Establece este valor como falso cuando el artículo no tenga identificadores únicos de producto adecuados para su categoría, como el GTIN, el MPN y la marca. Si no se proporciona, el valor predeterminado es verdadero. |
is |
Indica si el artículo es un paquete definido por el comercio. Un paquete es una agrupación personalizada de diferentes productos que vende un comercio por un precio único. |
title |
Título del artículo |
description |
Descripción del artículo |
link |
URL que vincula directamente a la página del artículo en tu tienda en línea |
mobile |
Es la URL de la versión optimizada para dispositivos móviles de la página de destino de tu artículo. |
canonical |
Es la URL de la versión canónica de la página de destino de tu artículo. |
image |
Es la URL de una imagen del artículo. |
adult |
Se establece como verdadero si el artículo está dirigido a adultos. |
age |
Es el grupo etario objetivo del artículo. |
availability |
Estado de disponibilidad del artículo. |
brand |
Marca del artículo |
color |
Es el color del artículo. |
condition |
Es el estado o la condición del artículo. |
gender |
Es el género objetivo del artículo. |
google |
Es la categoría de Google del artículo (consulta la taxonomía de productos de Google). Cuando se consulten productos, este campo contendrá el valor que proporcionó el usuario. Actualmente, no hay forma de recuperar las categorías de productos de Google asignadas automáticamente a través de la API. |
item |
Es el identificador que comparten todas las variantes del mismo producto. |
material |
Es el material del que está hecho el artículo. |
mpn |
Es el número de pieza del fabricante (MPN) del artículo. |
pattern |
El diseño del artículo (por ejemplo, lunares). |
sell |
Es la cantidad del producto que está disponible para vender en Google. Solo es compatible con los productos en línea. |
max |
Es el tiempo máximo de preparación de los productos (en días hábiles). |
min |
Es el tiempo mínimo de preparación del producto (en días hábiles). |
shipping |
Es la etiqueta de envío del producto, que se usa para agrupar productos en reglas de envío a nivel de la cuenta. |
transit |
Es la etiqueta de tiempo en tránsito del producto, que se usa para agrupar productos en tablas de tiempo en tránsito a nivel de la cuenta. |
size |
Es el tamaño del artículo. Solo se permite un valor. Para las variantes con diferentes tamaños, inserta un producto independiente para cada tamaño con el mismo valor de |
size |
Es el sistema en el que se especifica el tamaño. Se recomienda para artículos de indumentaria. |
tax |
Es la categoría fiscal del producto, que se usa para configurar el nexo fiscal detallado en la configuración de impuestos a nivel de la cuenta. |
energy |
Es el nivel de eficiencia energética, tal como se define en la Directiva 2010/30/UE de la UE. |
min |
Es el nivel de eficiencia energética, tal como se define en la Directiva 2010/30/UE de la UE. |
max |
Es el nivel de eficiencia energética definido en la Directiva 2010/30/UE de la UE. |
multipack |
Es la cantidad de productos idénticos en un multipack definido por el comercio. |
ads |
Se usa para agrupar elementos de forma arbitraria. Solo para CPA%, no se recomienda en otros casos. |
ads |
Permite que los anunciantes anulen la URL del artículo cuando el producto se muestra en el contexto de los anuncios de productos. |
display |
Es un identificador de un artículo para las campañas de remarketing dinámico. |
display |
Es el título de un artículo para las campañas de remarketing dinámico. |
display |
Es la URL que lleva directamente a la página de destino de tu artículo para las campañas de remarketing dinámico. |
display |
Margen de oferta para las campañas de remarketing dinámico. |
pickup |
Es la opción de retiro del artículo. |
pickup |
Es el cronograma de retiro en tienda del artículo. |
link |
Plantilla de vínculo para la tienda local alojada por el comerciante. |
mobile |
Es la plantilla de vínculo para la tienda local alojada por el comerciante optimizada para dispositivos móviles. |
custom |
Etiqueta personalizada 0 para la agrupación personalizada de artículos en una campaña de Shopping. |
custom |
Etiqueta personalizada 1 para la agrupación personalizada de artículos en una campaña de Shopping. |
custom |
Etiqueta personalizada 2 para la agrupación personalizada de artículos en una campaña de Shopping. |
custom |
Etiqueta personalizada 3 para la agrupación personalizada de artículos en una campaña de Shopping. |
custom |
Etiqueta personalizada 4 para la agrupación personalizada de artículos en una campaña de Shopping |
external |
Obligatorio para las cuentas de varios vendedores. Usa este atributo si representas a un mercado que sube productos para varios vendedores a tu cuenta de varios vendedores. |
pause |
La publicación de este elemento se detendrá temporalmente. |
virtual |
Es la URL de la imagen en 3D del artículo. Consulta el artículo del Centro de ayuda para obtener más información. |
structured |
Título estructurado para los títulos generados por algoritmos (IA). |
structured |
Descripción estructurada para descripciones generadas de forma algorítmica (IA). |
Cuota
Un mensaje que representa una cuota.
Representación JSON |
---|
{ "months": string, "amount": { object ( |
Campos | |
---|---|
months |
Es la cantidad de cuotas en las que el comprador debe efectuar el pago. |
amount |
Es el importe que el comprador debe pagar por mes. |
downpayment |
Es el importe del pago inicial que el comprador debe pagar por adelantado. |
credit |
Tipo de pagos en cuotas. Los valores admitidos son los siguientes: * " |
SubscriptionCost
Es el SubscriptionCost del producto.
Representación JSON |
---|
{ "period": enum ( |
Campos | |
---|---|
period |
Es el tipo de período de suscripción. Los valores admitidos son los siguientes: * " |
period |
Es la cantidad de períodos de suscripción que debe pagar el comprador. |
amount |
Es el importe que el comprador debe pagar por período de suscripción. |
SubscriptionPeriod
Es el período de suscripción del producto.
Enumeraciones | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
Indica que no se especificó el período de la suscripción. |
MONTH |
Indica que el período de la suscripción es mensual. |
YEAR |
Indica que el período de suscripción es de un año. |
LoyaltyPoints
Un mensaje que representa puntos de lealtad.
Representación JSON |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
Campos | |
---|---|
name |
Es el nombre del programa de puntos de lealtad. Se recomienda limitar el nombre a 12 caracteres de ancho completo o 24 caracteres romanos. |
points |
Son los puntos de lealtad del minorista en valor absoluto. |
ratio |
Es la proporción que se usa para convertir un punto en moneda. Google supone la moneda según la configuración de Merchant Center. Si no se incluye la proporción, el valor predeterminado es 1.0. |
LoyaltyProgram
Es un mensaje que representa el programa de lealtad.
Representación JSON |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
Campos | |
---|---|
program |
Es la etiqueta del programa de lealtad. Es una etiqueta interna que identifica de forma exclusiva la relación entre una entidad de comercio y una entidad de programa de lealtad. Se debe proporcionar la etiqueta para que el sistema pueda asociar los recursos que se indican a continuación (por ejemplo, el precio y los puntos) con un comercio. El programa correspondiente debe estar vinculado a la cuenta del comerciante. |
tier |
Es la etiqueta del nivel dentro del programa de lealtad. Debe coincidir con una de las etiquetas del programa. |
price |
Es el precio para los miembros del nivel determinado, es decir, el precio con descuento instantáneo. Debe ser menor o igual que el precio normal. |
cashback |
El reembolso que se puede usar para compras futuras. |
loyalty |
Es la cantidad de puntos de lealtad que se obtienen en una compra. |
member |
Es un período durante el cual el artículo es apto para el precio para miembros. Si no se especifica, siempre se aplica el precio para miembros. El período se representa con un par de fechas ISO 8601 separadas por un espacio, una coma o una barra. |
shipping |
Es la etiqueta del beneficio de envío. Si el campo tiene un valor, significa que esta oferta tiene un beneficio de envío mediante programas de lealtad. Si no se proporciona el valor del campo, el artículo no es apto para el envío mediante programas de lealtad del nivel de lealtad determinado. |
ProductDimension
Es la dimensión del producto.
Representación JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
Obligatorio. Es el valor de la dimensión representado como un número. El valor puede tener una precisión máxima de cuatro decimales. |
unit |
Obligatorio. Las unidades de dimensión. Los valores aceptables son: * " |
ProductWeight
Es el peso del producto.
Representación JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
Obligatorio. El peso representado como un número. El peso puede tener una precisión máxima de cuatro decimales. |
unit |
Obligatorio. La unidad de peso. Los valores aceptables son: * " |
Envío
El envío del producto.
Representación JSON |
---|
{
"price": {
object ( |
Campos | |
---|---|
price |
Es el precio de envío fijo, representado como un número. |
country |
Es el código de territorio de CLDR del país al que se enviará un artículo. |
region |
Es la región geográfica a la que se aplica una tarifa de envío. Consulta región para obtener más información. |
service |
Una descripción de formato libre del tipo de servicio o la velocidad de entrega. |
location |
Es el ID numérico de una ubicación a la que se aplica la tarifa de envío, según se define en la API de AdWords. |
location |
La ubicación a la que se aplica el envío, representada por un nombre de grupo por ubicación. |
postal |
Es el intervalo de códigos postales al que se aplica la tarifa de envío, representado por un código postal, un prefijo de código postal seguido de un comodín *, un intervalo entre dos códigos postales o dos prefijos de código postal de la misma longitud. |
min |
Es el tiempo de preparación mínimo (inclusive) entre el momento en que se recibe el pedido y el momento en que se envía en días hábiles. 0 significa que el pedido se envía el mismo día en que se recibe, si esto ocurre antes de la hora límite. |
max |
Es el tiempo de preparación máximo (inclusive) entre el momento en que se recibe el pedido y el momento en que se envía en días hábiles. 0 significa que el pedido se envía el mismo día en que se recibe, si esto ocurre antes de la hora límite. Se requieren |
min |
Es el tiempo mínimo en tránsito (inclusive) entre el momento en que se envía el pedido y el momento en que se entrega en días hábiles. 0 significa que el pedido se entrega el mismo día en que se envía. |
max |
Es el tiempo máximo en tránsito (inclusive) entre el momento en que se envía el pedido y el momento en que se entrega en días hábiles. 0 significa que el pedido se entrega el mismo día en que se envía. Se requieren |
FreeShippingThreshold
Condiciones que se deben cumplir para que un producto tenga envío gratis.
Representación JSON |
---|
{
"country": string,
"priceThreshold": {
object ( |
Campos | |
---|---|
country |
Es el código de territorio de CLDR del país al que se enviará un artículo. |
price |
Es el precio mínimo del producto para que el costo de envío sea gratuito. Se representa como un número. |
ShippingWeight
Es el atributo ShippingWeight del producto.
Representación JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
Es el peso del producto que se usa para calcular el costo de envío del artículo. |
unit |
La unidad de valor. |
ShippingDimension
Es la ShippingDimension del producto.
Representación JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
Es la dimensión del producto que se usa para calcular el costo de envío del artículo. |
unit |
La unidad de valor. |
Impuesto
Es el impuesto del producto.
Representación JSON |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
Campos | |
---|---|
rate |
Es el porcentaje de la tasa impositiva que se aplica al precio del artículo. |
country |
Es el país en el que se grava el artículo, especificado como un código de territorio de CLDR. |
region |
Es la región geográfica a la que se aplica la tasa impositiva. |
tax |
Establece como verdadero si se cobra un impuesto sobre el envío. |
location |
Es el ID numérico de una ubicación a la que se aplica la tasa impositiva, según se define en la API de AdWords. |
postal |
Es el intervalo de códigos postales al que se aplica la tasa impositiva, representado por un código postal, un prefijo de código postal con el comodín *, un intervalo entre dos códigos postales o dos prefijos de código postal de la misma longitud. Ejemplos: 94114, 94*, 94002-95460, 94*-95*. |
UnitPricingMeasure
Es la UnitPricingMeasure del producto.
Representación JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
Es la medida de un artículo. |
unit |
La unidad de la medida. |
UnitPricingBaseMeasure
Es la UnitPricingBaseMeasure del producto.
Representación JSON |
---|
{ "value": string, "unit": string } |
Campos | |
---|---|
value |
Es el denominador del precio unitario. |
unit |
Es la unidad del denominador. |
ProductDetail
Los detalles del producto.
Representación JSON |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
Campos | |
---|---|
section |
Es el encabezado de la sección que se usa para agrupar un conjunto de detalles del producto. |
attribute |
Es el nombre del detalle del producto. |
attribute |
Es el valor del detalle del producto. |
CloudExportAdditionalProperties
Es la propiedad del producto para la API de Cloud Retail. Por ejemplo, las propiedades de un producto de TV podrían ser "Screen-Resolution" o "Screen-Size".
Representación JSON |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
Campos | |
---|---|
text |
Es el valor de texto de la propiedad determinada. Por ejemplo, "8K(UHD)" podría ser un valor de texto para un producto de TV. La repetición máxima de este valor es de 400. Los valores se almacenan en un orden arbitrario, pero coherente. El tamaño máximo de la cadena es de 256 caracteres. |
int |
Valores enteros de la propiedad determinada. Por ejemplo, 1080 para la resolución de pantalla de un producto de TV. La repetición máxima de este valor es de 400. Los valores se almacenan en un orden arbitrario, pero coherente. |
float |
Valores de número de punto flotante de la propiedad determinada. Por ejemplo, para un producto de TV, 1.2345. La repetición máxima de este valor es de 400. Los valores se almacenan en un orden arbitrario, pero coherente. |
property |
Es el nombre de la propiedad determinada. Por ejemplo, "Screen-Resolution" para un producto de TV. El tamaño máximo de la cadena es de 256 caracteres. |
bool |
Es el valor booleano de la propiedad determinada. Por ejemplo, para un producto de TV, "Verdadero" o "Falso" si la pantalla es UHD. |
min |
Es el valor mínimo de número de punto flotante de la propiedad determinada. Por ejemplo, para un producto de TV, 1.00. |
max |
Es el valor máximo de número de punto flotante de la propiedad determinada. Por ejemplo, para un producto de TV, 100.00. |
unit |
Es la unidad de la propiedad determinada. Por ejemplo, “Pixels” para un producto de TV. El tamaño máximo de la cadena es de 256 B. |
Certificación
Certificación de productos, que se introdujo inicialmente para el cumplimiento del etiquetado de eficiencia energética de la UE con la base de datos del EPREL de la UE
Representación JSON |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
Campos | |
---|---|
certification |
La autoridad certificadora, por ejemplo, "European_Commission". La longitud máxima es de 2,000 caracteres. |
certification |
Es el nombre de la certificación, por ejemplo, "EPREL". La longitud máxima es de 2,000 caracteres. |
certification |
El código de certificación La longitud máxima es de 2,000 caracteres. |
certification |
Es el valor de la certificación (también conocido como clase, nivel o calificación), por ejemplo, "A+", "C", "oro". La longitud máxima es de 2,000 caracteres. |
ProductStructuredTitle
Título estructurado para los títulos generados por algoritmos (IA).
Representación JSON |
---|
{ "digitalSourceType": string, "content": string } |
Campos | |
---|---|
digital |
El tipo de fuente digital, por ejemplo, "trained_algorithmic_media". Sigue el IPTC. La longitud máxima es de 40 caracteres. |
content |
La longitud máxima del texto del título es de 150 caracteres. |
ProductStructuredDescription
Descripción estructurada para descripciones generadas de forma algorítmica (IA).
Representación JSON |
---|
{ "digitalSourceType": string, "content": string } |
Campos | |
---|---|
digital |
El tipo de fuente digital, por ejemplo, "trained_algorithmic_media". Sigue el IPTC. La longitud máxima es de 40 caracteres. |
content |
La longitud máxima del texto de la descripción es de 5,000 caracteres. |