REST Resource: accounts.cssProducts

Recurso: CssProduct

Es el producto de CSS procesado.

Representación JSON
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Campos
name

string

Es el nombre del producto de CSS. Formato: "accounts/{account}/cssProducts/{css_product}"

rawProvidedId

string

Solo salida. Es el identificador sin procesar único del producto.

contentLanguage

string

Solo salida. El código de idioma ISO 639-1 de dos letras del producto.

feedLabel

string

Solo salida. Es la etiqueta de feed del producto.

attributes

object (Attributes)

Solo salida. Es una lista de atributos de producto.

customAttributes[]

object (CustomAttribute)

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, { "name": "size type", "value": "regular" }). Esto es útil para enviar atributos que la API no expone de forma explícita, como los atributos adicionales que se usan en Comprar con Google.

cssProductStatus

object (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 (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
Campos
lowPrice

object (Price)

Precio bajo del producto del CSS

highPrice

object (Price)

Es el precio alto del producto del CSS.

headlineOfferPrice

object (Price)

Es el precio titular del producto del CSS.

headlineOfferShippingPrice

object (Price)

Es el precio titular del producto del CSS.

productTypes[]

string

Son las categorías del artículo (con el formato de las especificaciones de datos de productos).

sizeTypes[]

string

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[]

object (ProductDetail)

Especificaciones técnicas o detalles adicionales del producto.

productWeight

object (ProductWeight)

Es el peso del producto en las unidades proporcionadas. El valor debe ser mayor que 0 y menor o igual que 2000.

productLength

object (ProductDimension)

Es la longitud del producto en las unidades proporcionadas. El valor debe ser de entre 0 (excluido) y 3,000 (incluido).

productWidth

object (ProductDimension)

Es el ancho del producto en las unidades proporcionadas. El valor debe ser de entre 0 (excluido) y 3000 (incluido).

productHeight

object (ProductDimension)

Es la altura del producto en las unidades proporcionadas. El valor debe ser de entre 0 (excluido) y 3,000 (incluido).

productHighlights[]

string

Son viñetas que describen los aspectos más destacados de un producto.

certifications[]

object (Certification)

Es una lista de certificados que el CSS reclama para el producto determinado.

expirationDate

string (Timestamp format)

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 productstatuses como googleExpirationDate y podría ser anterior si expirationDate es demasiado lejana. Nota: Es posible que el elemento tarde más de 2 días en borrarse después de la fecha de vencimiento.

includedDestinations[]

string

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 excludedDestinations.

Los valores admitidos son los siguientes: - css_ads_experiences - css_organic_experiences

excludedDestinations[]

string

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: - css_ads_experiences - css_organic_experiences

headlineOfferInstallment

object (HeadlineOfferInstallment)

Es la cantidad y el importe de las cuotas que se deben pagar por un artículo.

headlineOfferSubscriptionCost

object (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.

cppAdsRedirect

string

Permite que los anunciantes anulen la URL del artículo cuando el producto se muestra en el contexto de los anuncios de productos.

numberOfOffers

string (int64 format)

Es la cantidad de productos de CSS.

headlineOfferCondition

string

Es el estado de la oferta titular.

title

string

Título del artículo

description

string

Es la descripción del artículo.

brand

string

Atributos relacionados con el producto.[14-36] Marca del artículo.

mpn

string

Es el número de pieza del fabricante (MPN) del artículo.

gtin

string

Es el código comercial global de artículo (GTIN) correspondiente.

googleProductCategory

string

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

boolean

Se configura como verdadero si el artículo está dirigido a adultos.

multipack

string (int64 format)

Es la cantidad de productos idénticos en un multipack definido por el comercio.

isBundle

boolean

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

string

Es el grupo de edad objetivo del artículo.

color

string

Es el color del artículo.

gender

string

Es el género al que se destina el artículo.

material

string

Es el material con el que se fabrica el artículo.

pattern

string

Es el diseño del artículo (p.ej., con lunares).

size

string

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 itemGroupId (consulta la [definición de tamaño](https://support.google.com/merchants/answer/6324492)).

sizeSystem

string

Es el sistema en el que se especifica la talla. Se recomienda para los artículos de indumentaria.

itemGroupId

string

Es el identificador compartido para todas las variantes del mismo producto.

pause

string

La publicación de este elemento se detendrá temporalmente.

customLabel0

string

Es la etiqueta personalizada 0 para la agrupación personalizada de artículos en una campaña de Shopping.

customLabel1

string

Es la etiqueta personalizada 1 para la agrupación personalizada de artículos en una campaña de Shopping.

customLabel2

string

Es la etiqueta personalizada 2 para la agrupación personalizada de artículos en una campaña de Shopping.

customLabel3

string

Es la etiqueta personalizada 3 para la agrupación personalizada de artículos en una campaña de Shopping.

customLabel4

string

Es la etiqueta personalizada 4 para la agrupación personalizada de artículos en una campaña de Shopping.

reviewCount

string (int64 format)

Es la cantidad de opiniones sobre el producto. Obligatorio si se proporciona rating.

minRating

string (int64 format)

Es la puntuación mínima de la calificación del producto. Obligatorio si se proporciona rating.

maxRating

string (int64 format)

Es la puntuación máxima de la calificación del producto. Obligatorio si se proporciona rating.

rating

number

Es la calificación promedio del producto. El valor debe estar dentro del rango de [minRating, maxRating], inclusive. Cuando se muestra en la página del producto, esta calificación se normaliza en una escala de [1, 5] con un decimal. Si se proporciona, también se requieren reviewCount, minRating y maxRating.

Precio

Es el precio representado como un número y una moneda.

Representación JSON
{
  "amountMicros": string,
  "currencyCode": string
}
Campos
amountMicros

string (int64 format)

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

string

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

string

Es el encabezado de la sección que se usa para agrupar un conjunto de detalles del producto.

attributeName

string

Es el nombre del detalle del producto.

attributeValue

string

Es el valor del detalle del producto.

ProductWeight

Es el peso del producto.

Representación JSON
{
  "value": number,
  "unit": string
}
Campos
value

number

Obligatorio. Es el peso representado como un número. El peso puede tener una precisión máxima de cuatro decimales.

unit

string

Obligatorio. Es la unidad de peso. Los valores aceptables son los siguientes: * "g" * "kg" * "oz" * "lb"

ProductDimension

Es la dimensión del producto.

Representación JSON
{
  "value": number,
  "unit": string
}
Campos
value

number

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

string

Obligatorio. Son las unidades de dimensión. Los valores aceptables son los siguientes: * "in" * "cm"

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

string

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

string

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

string

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 (Price)
  },
  "downpayment": {
    object (Price)
  }
}
Campos
months

string (int64 format)

Es la cantidad de cuotas que debe pagar el comprador.

amount

object (Price)

Es el importe que debe pagar el comprador por mes.

downpayment

object (Price)

Es el importe del pago inicial que debe pagar el comprador por adelantado.

HeadlineOfferSubscriptionCost

Es el SubscriptionCost del producto.

Representación JSON
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Campos
period

enum (SubscriptionPeriod)

Es el tipo de período de suscripción. Los valores admitidos son los siguientes: * "month" * "year"

periodLength

string (int64 format)

Es la cantidad de períodos de suscripción que debe pagar el comprador.

amount

object (Price)

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 (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Campos
groupValues[]

object (CustomAttribute)

Son los atributos secundarios dentro de este grupo de atributos. Si groupValues no está vacío, value debe estar vacío.

name

string

Es el nombre del atributo.

value

string

Es el valor del atributo. Si value no está vacío, groupValues debe estar vacío.

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 (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Campos
destinationStatuses[]

object (DestinationStatus)

Los destinos objetivos para el producto.

itemLevelIssues[]

object (ItemLevelIssue)

Es una lista de todos los problemas asociados con el producto.

creationDate

string (Timestamp format)

Es la fecha en la que se creó el elemento, en formato ISO 8601.

lastUpdateDate

string (Timestamp format)

Es la fecha en la que se actualizó el artículo por última vez, en formato ISO 8601.

googleExpirationDate

string (Timestamp format)

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

string

El nombre del destino

approvedCountries[]

string

Es la lista de códigos de país (ISO 3166-1 alfa-2) en los que se aprueba el producto de CSS.

pendingCountries[]

string

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[]

string

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

string

El código de error del problema.

servability

string

Cómo afecta este problema a la publicación del producto de CSS

resolution

string

Si el comercio puede resolver el problema.

attribute

string

El nombre del atributo, si el problema se debe a un solo atributo.

destination

string

El destino al que se aplica el problema.

description

string

Una descripción breve del problema en inglés.

detail

string

Una descripción detallada del problema en inglés

documentation

string

Es la URL de una página web para ayudar a resolver este problema.

applicableCountries[]

string

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

get

Recupera el producto de CSS procesado de tu cuenta de CSS Center.

list

Enumera los productos de CSS procesados en tu cuenta de CSS Center.