- Recurso: CssProduct
- Atributos
- Precio
- ProductDetail
- ProductWeight
- ProductDimension
- Certificación
- HeadlineOfferInstallment
- HeadlineOfferSubscriptionCost
- SubscriptionPeriod
- CustomAttribute
- CssProductStatus
- DestinationStatus
- ItemLevelIssue
- Métodos
Recurso: CssProduct
Es el producto de CSS procesado.
| Representación JSON |
|---|
{ "name": string, "rawProvidedId": string, "contentLanguage": string, "feedLabel": string, "attributes": { object ( |
| Campos | |
|---|---|
name |
Es el nombre del producto de CSS. Formato: |
rawProvidedId |
Solo salida. Es el identificador sin procesar único del producto. |
contentLanguage |
Solo salida. El código de idioma ISO 639-1 de dos letras del producto. |
feedLabel |
Solo salida. Es la etiqueta de feed del producto. |
attributes |
Solo salida. Es una lista de atributos de producto. |
customAttributes[] |
Solo salida. Es una lista de atributos personalizados (proporcionados por el CSS). También se puede usar para enviar cualquier atributo de la especificación del feed en su forma genérica (por ejemplo, |
cssProductStatus |
Solo salida. Es el estado de un producto, los problemas de validación de datos, es decir, la información sobre un producto calculada de forma asíncrona. |
Atributos
Atributos del producto de CSS.
| Representación JSON |
|---|
{ "lowPrice": { object ( |
| Campos | |
|---|---|
lowPrice |
Precio bajo del producto del CSS |
highPrice |
Es el precio alto del producto del CSS. |
headlineOfferPrice |
Es el precio titular del producto del CSS. |
headlineOfferShippingPrice |
Es el precio titular del producto del CSS. |
additionalImageLinks[] |
URLs adicionales de imágenes del artículo. |
productTypes[] |
Son las categorías del artículo (con el formato de las especificaciones de datos de productos). |
sizeTypes[] |
Es el corte del artículo. Se puede usar para representar tipos de tallas combinadas para artículos de indumentaria. Se pueden proporcionar dos tipos de tallas como máximo (consulta tipo de talla). |
productDetails[] |
Especificaciones técnicas o detalles adicionales del producto. |
productWeight |
Es el peso del producto en las unidades proporcionadas. El valor debe ser mayor que 0 y menor o igual que 2000. |
productLength |
Es la longitud del producto en las unidades proporcionadas. El valor debe ser de entre 0 (excluido) y 3,000 (incluido). |
productWidth |
Es el ancho del producto en las unidades proporcionadas. El valor debe ser de entre 0 (excluido) y 3000 (incluido). |
productHeight |
Es la altura del producto en las unidades proporcionadas. El valor debe ser de entre 0 (excluido) y 3,000 (incluido). |
productHighlights[] |
Son viñetas que describen los aspectos más destacados de un producto. |
certifications[] |
Es una lista de certificados que el CSS reclama para el producto determinado. |
expirationDate |
Es la fecha en la que el artículo debe caducar, como se especifica cuando se inserta, en formato ISO 8601. La fecha de vencimiento real se expone en |
includedDestinations[] |
Es la lista de destinos que se incluirán en esta segmentación (corresponde a las casillas de verificación marcadas en Merchant Center). Los destinos predeterminados siempre se incluyen, a menos que se proporcionen en Los valores admitidos son los siguientes: - |
excludedDestinations[] |
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). Los valores admitidos son los siguientes: - |
headlineOfferInstallment |
Es la cantidad y el importe de las cuotas que se deben pagar por un artículo. |
headlineOfferSubscriptionCost |
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. |
cppLink |
Es la URL que vincula directamente a la página de detalles del producto del CSS. |
cppMobileLink |
Es la URL de la versión optimizada para dispositivos móviles de la página de detalles del producto del CSS. |
cppAdsRedirect |
Permite que los anunciantes anulen la URL del artículo cuando el producto se muestra en el contexto de los anuncios de productos. |
numberOfOffers |
Es la cantidad de productos de CSS. |
headlineOfferCondition |
Es el estado de la oferta titular. |
headlineOfferLink |
Es el vínculo a la oferta titular. |
headlineOfferMobileLink |
Es el vínculo móvil a la oferta titular. |
title |
Título del artículo |
imageLink |
Es la URL de una imagen del artículo. |
description |
Es la descripción del artículo. |
brand |
Atributos relacionados con el producto.[14-36] Marca del artículo. |
mpn |
Es el número de pieza del fabricante (MPN) del artículo. |
gtin |
Es el código comercial global de artículo (GTIN) correspondiente. |
googleProductCategory |
Es la categoría de Google del artículo (consulta la taxonomía de productos de Google). Cuando se consulten los productos, este campo contendrá el valor proporcionado por el usuario. Actualmente, no hay forma de recuperar las categorías de productos de Google asignadas automáticamente a través de la API. |
adult |
Se configura como verdadero si el artículo está dirigido a adultos. |
multipack |
Es la cantidad de productos idénticos en un multipack definido por el comercio. |
isBundle |
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. |
ageGroup |
Es el grupo de edad objetivo del artículo. |
color |
Es el color del artículo. |
gender |
Es el género al que se destina el artículo. |
material |
Es el material con el que se fabrica el artículo. |
pattern |
Es el diseño del artículo (p.ej., con lunares). |
size |
Es el tamaño del artículo. Solo se permite un valor. En el caso de las variantes con diferentes tamaños, inserta un producto independiente para cada tamaño con el mismo valor de |
sizeSystem |
Es el sistema en el que se especifica la talla. Se recomienda para los artículos de indumentaria. |
itemGroupId |
Es el identificador compartido para todas las variantes del mismo producto. |
pause |
La publicación de este elemento se detendrá temporalmente. |
customLabel0 |
Es la etiqueta personalizada 0 para la agrupación personalizada de artículos en una campaña de Shopping. |
customLabel1 |
Es la etiqueta personalizada 1 para la agrupación personalizada de artículos en una campaña de Shopping. |
customLabel2 |
Es la etiqueta personalizada 2 para la agrupación personalizada de artículos en una campaña de Shopping. |
customLabel3 |
Es la etiqueta personalizada 3 para la agrupación personalizada de artículos en una campaña de Shopping. |
customLabel4 |
Es la etiqueta personalizada 4 para la agrupación personalizada de artículos en una campaña de Shopping. |
reviewCount |
Es la cantidad de opiniones sobre el producto. Obligatorio si se proporciona |
minRating |
Es la puntuación mínima de la calificación del producto. Obligatorio si se proporciona |
maxRating |
Es la puntuación máxima de la calificación del producto. Obligatorio si se proporciona |
rating |
Es la calificación promedio del producto. El valor debe estar dentro del rango de [ |
Precio
Es el precio representado como un número y una moneda.
| Representación JSON |
|---|
{ "amountMicros": string, "currencyCode": string } |
| Campos | |
|---|---|
amountMicros |
Es el precio representado como un número en micros (1 millón de micros equivale a una unidad estándar de la moneda, por ejemplo, USD 1 = 1,000,000 de micros). |
currencyCode |
Es la moneda del precio con acrónimos de tres letras según la norma ISO 4217. |
ProductDetail
Son los detalles del producto.
| Representación JSON |
|---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
| Campos | |
|---|---|
sectionName |
Es el encabezado de la sección que se usa para agrupar un conjunto de detalles del producto. |
attributeName |
Es el nombre del detalle del producto. |
attributeValue |
Es el valor del detalle del producto. |
ProductWeight
Es el peso del producto.
| Representación JSON |
|---|
{ "value": number, "unit": string } |
| Campos | |
|---|---|
value |
Obligatorio. Es el peso representado como un número. El peso puede tener una precisión máxima de cuatro decimales. |
unit |
Obligatorio. Es la unidad de peso. Los valores aceptables son los siguientes: * " |
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. Son las unidades de dimensión. Los valores aceptables son los siguientes: * " |
Certificación
Es la certificación del producto. Usa este atributo para describir las certificaciones, como las calificaciones de eficiencia energética, asociadas con un producto.
| Representación JSON |
|---|
{ "name": string, "authority": string, "code": string } |
| Campos | |
|---|---|
name |
Es el nombre de la certificación. Por el momento, el valor más común es "EPREL", que representa las certificaciones de eficiencia energética en la base de datos del Registro Europeo de Productos para el Etiquetado Energético (EPREL) de la UE. |
authority |
Es la autoridad o el organismo de certificación responsable de emitir la certificación. Por el momento, el valor más común es "EC" o "European_Commission" para las etiquetas de eficiencia energética en la UE. |
code |
Es el código de la certificación. Por ejemplo, para el certificado EPREL con el vínculo https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, el código es 123456. El código es obligatorio para las etiquetas de eficiencia energética europeas. |
HeadlineOfferInstallment
Es un mensaje que representa la cuota.
| Representación JSON |
|---|
{ "months": string, "amount": { object ( |
| Campos | |
|---|---|
months |
Es la cantidad de cuotas que debe pagar el comprador. |
amount |
Es el importe que debe pagar el comprador por mes. |
downpayment |
Es el importe del pago inicial que debe pagar el comprador por adelantado. |
HeadlineOfferSubscriptionCost
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: * " |
periodLength |
Es la cantidad de períodos de suscripción que debe pagar el comprador. |
amount |
Es el importe que debe pagar el comprador por período de suscripción. |
SubscriptionPeriod
Es el período de suscripción del producto.
| Enums | |
|---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
Indica que no se especificó el período de suscripción. |
MONTH |
Indica que el período de suscripción es mensual. |
YEAR |
Indica que el período de suscripción es de un año. |
CustomAttribute
Es un mensaje que representa atributos personalizados. Exactamente uno de los valores value o groupValues no debe estar vacío.
| Representación JSON |
|---|
{
"groupValues": [
{
object ( |
| Campos | |
|---|---|
groupValues[] |
Son los atributos secundarios dentro de este grupo de atributos. Si |
name |
Es el nombre del atributo. |
value |
Es el valor del atributo. Si |
CssProductStatus
Es el estado del producto de CSS, es decir, los problemas de validación de datos, que es la información sobre el producto de CSS calculada de forma asíncrona.
| Representación JSON |
|---|
{ "destinationStatuses": [ { object ( |
| Campos | |
|---|---|
destinationStatuses[] |
Los destinos objetivos para el producto. |
itemLevelIssues[] |
Es una lista de todos los problemas asociados con el producto. |
creationDate |
Es la fecha en la que se creó el elemento, en formato ISO 8601. |
lastUpdateDate |
Es la fecha en la que se actualizó el artículo por última vez, en formato ISO 8601. |
googleExpirationDate |
Es la fecha en la que vence el artículo, en formato ISO 8601. |
DestinationStatus
Es el estado de destino del estado del producto.
| Representación JSON |
|---|
{ "destination": string, "approvedCountries": [ string ], "pendingCountries": [ string ], "disapprovedCountries": [ string ] } |
| Campos | |
|---|---|
destination |
El nombre del destino |
approvedCountries[] |
Es la lista de códigos de país (ISO 3166-1 alfa-2) en los que se aprueba el producto de CSS. |
pendingCountries[] |
Es la lista de códigos de país (ISO 3166-1 alfa-2) en los que el producto de CSS está pendiente de aprobación. |
disapprovedCountries[] |
Es la lista de códigos de país (ISO 3166-1 alfa-2) en los que se rechazó el producto de CSS. |
ItemLevelIssue
Es el ItemLevelIssue del estado del producto.
| Representación JSON |
|---|
{ "code": string, "servability": string, "resolution": string, "attribute": string, "destination": string, "description": string, "detail": string, "documentation": string, "applicableCountries": [ string ] } |
| Campos | |
|---|---|
code |
El código de error del problema. |
servability |
Cómo afecta este problema a la publicación del producto de CSS |
resolution |
Si el comercio puede resolver el problema. |
attribute |
El nombre del atributo, si el problema se debe a un solo atributo. |
destination |
El destino al que se aplica el problema. |
description |
Una descripción breve del problema en inglés. |
detail |
Una descripción detallada del problema en inglés |
documentation |
Es la URL de una página web para ayudar a resolver este problema. |
applicableCountries[] |
Es la lista de códigos de país (ISO 3166-1 alfa-2) en los que el problema se aplica al producto de CSS. |
Métodos |
|
|---|---|
|
Recupera el producto de CSS procesado de tu cuenta de CSS Center. |
|
Enumera los productos de CSS procesados en tu cuenta de CSS Center. |