REST Resource: accounts.products

Recurso: Producto

El producto procesado, creado a partir de varios product inputs después de aplicar reglas y fuentes de datos complementarias Este producto procesado coincide con lo que se muestra en tu cuenta de Merchant Center, en los anuncios de Shopping y en otras plataformas de Google. Cada producto se crea a partir de exactamente una entrada de producto de la fuente de datos principal y varias entradas de fuentes de datos complementarias. Después de insertar, actualizar o borrar una entrada de producto, es posible que debas esperar varios minutos para poder recuperar el producto procesado actualizado.

Todos los campos del producto procesado y sus submensajes coinciden con el nombre de su atributo correspondiente en las especificaciones de datos de productos, con algunas excepciones.

Representación JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Campos
name

string

Es el nombre del producto. Formato: "{product.name=accounts/{account}/products/{product}}", donde la última sección product consta de 4 partes: channel~contentLanguage~feedLabel~offerId. Un ejemplo de nombre de producto es "accounts/123/products/online~en~US~sku123".
channel

enum (ChannelEnum)

Solo salida. Es el canal del producto.
offerId

string

Solo salida. Es tu identificador único para el producto. Esto es igual para la entrada del producto y el producto procesado. Los espacios en blanco iniciales y finales se quitan, y los espacios en blanco múltiples se reemplazan por un solo espacio en blanco cuando se envía el contenido. Consulta las especificaciones de datos de productos para obtener más detalles.
contentLanguage

string

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

string

Solo salida. Es la etiqueta del feed del producto.
dataSource

string

Solo salida. Es la fuente de datos principal del producto.
attributes

object (Attributes)

Solo salida. Es una lista de atributos del producto.
customAttributes[]

object (CustomAttribute)

Solo salida. Es una lista de atributos personalizados (proporcionados por el comercio). También se puede usar para enviar cualquier atributo de la especificación de datos 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 para Comprar con Google.
productStatus

object (ProductStatus)

Solo salida. El estado de un producto, los problemas de validación de datos, es decir, la información sobre un producto que se calcula de forma asíncrona.
versionNumber

string (int64 format)

Solo salida. Representa la versión existente (actualización) del producto, que se puede usar para preservar el orden correcto cuando se realizan varias actualizaciones al mismo tiempo.

Si se establece, se evita la inserción cuando el número de versión es inferior al número de versión actual del producto existente. La inserción nuevamente (por ejemplo, la actualización de productos después de 30 días) se puede realizar con el versionNumber actual.

Solo se admite para inserciones en fuentes de datos principales.

Si se evita la operación, se arrojará la excepción abortada.

ProductStatus

El estado de un producto, los problemas de validación de datos, es decir, la información sobre un producto que se calcula 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)

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 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Campos
reportingContext

enum (ReportingContextEnum)

Es el nombre del contexto de informes.
approvedCountries[]

string

Es la lista de códigos de país (ISO 3166-1 alpha-2) en los que se aprobó la oferta.
pendingCountries[]

string

Es la lista de códigos de país (ISO 3166-1 alpha-2) en los que la oferta está pendiente de aprobación.
disapprovedCountries[]

string

Es la lista de códigos de país (ISO 3166-1 alpha-2) en los que se rechazó la oferta.

ItemLevelIssue

Es el ItemLevelIssue del estado del producto.

Representación JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Campos
code

string

El código de error del problema.
severity

enum (Severity)

Cómo afecta este problema a la publicación de la oferta,
resolution

string

Si el comercio puede resolver el problema.
attribute

string

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

enum (ReportingContextEnum)

Es el contexto de informes al que se aplica el problema.
description

string

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

string

Una descripción detallada del problema en inglés.
documentation

string

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 alpha-2) en los que el problema se aplica a la oferta.

Gravedad

Cómo afecta el problema a la publicación del producto

Enumeraciones
SEVERITY_UNSPECIFIED No se especifica.
NOT_IMPACTED Este problema representa una advertencia y no tiene un efecto directo en el producto.
DEMOTED El producto se degrada y, lo más probable, es que tenga un rendimiento limitado en los resultados de la búsqueda.
DISAPPROVED El problema rechaza el producto.

Métodos

get

 Recupera el producto procesado de tu cuenta de Merchant Center.

list

 Muestra una lista de los productos procesados en tu cuenta de Merchant Center.