REST Resource: accounts.productInputs

Recurso: ProductInput

Este recurso representa los datos de entrada que envías para un producto, no el producto procesado que ves en Merchant Center, en los anuncios de Shopping ni en las plataformas de Google. Las entradas de productos, las reglas y los datos de las fuentes de datos complementarias se combinan para crear el Product procesado.

Los atributos de entrada de productos obligatorios para aprobar las verificaciones de validación de datos se definen principalmente en las especificaciones de datos de productos.

Se requieren los siguientes atributos: feedLabel, contentLanguage y offerId.

Después de insertar, actualizar o borrar una entrada de producto, es posible que debas esperar varios minutos para poder recuperar el producto procesado.

Todos los campos de la entrada de productos y sus submensajes coinciden con el nombre en inglés de su atributo correspondiente en las especificaciones verticales, con algunas excepciones.

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

string

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

product

string

Solo salida. Es el nombre del producto procesado. Formato: "{product.name=accounts/{account}/products/{product}}"

channel

enum (ChannelEnum)

Obligatorio. Inmutable. Es el canal del producto.

offerId

string

Obligatorio. Inmutable. 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

Obligatorio. Inmutable. Es el código de idioma ISO 639-1 de dos letras del producto.

feedLabel

string

Obligatorio. Inmutable. La etiqueta del feed del producto.

attributes

object (Attributes)

Opcional. Es una lista de atributos del producto.

customAttributes[]

object (CustomAttribute)

Opcional. 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. La cantidad máxima de caracteres permitida para cada atributo personalizado es de 10,240 (representa la suma de caracteres para el nombre y el valor). Se pueden establecer un máximo de 2,500 atributos personalizados por producto, con un tamaño total de 102.4 KB. Los guiones bajos en los nombres de los atributos personalizados se reemplazan por espacios cuando se insertan.

versionNumber

string (int64 format)

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

Métodos

delete

Borra una entrada de producto de tu cuenta de Merchant Center.

insert

Sube una entrada de producto a tu cuenta de Merchant Center.