Method: accounts.productInputs.insert

Sube la entrada de un producto a tu cuenta de Merchant Center. Si ya existe una entrada con los mismos contentLanguage, offerId y dataSource, este método reemplaza esa entrada.

Después de insertar, actualizar o borrar la entrada de un producto, pueden pasar varios minutos antes de que se pueda recuperar el producto procesado.

Solicitud HTTP

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. La cuenta en la que se insertará este producto. Formato: cuentas/{account}

Parámetros de consulta

Parámetros
dataSource

string

Obligatorio. Es el nombre de la fuente de datos de productos principal o complementaria. Si el producto ya existe y la fuente de datos proporcionada es diferente, el producto se moverá a una nueva fuente de datos. Formato: accounts/{account}/dataSources/{datasource}.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ProductInput.

Cuerpo de la respuesta

Este recurso representa los datos de entrada que envías a un producto, no el producto procesado que ves en Merchant Center, los anuncios de Shopping o las plataformas de Google. Las entradas de productos, las reglas y los datos de fuentes de datos complementarios se combinan para crear el [producto][google.shopping.content.bundles.Products.Product].

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

Los siguientes atributos son obligatorios: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] y [offerId][google.shopping.content.bundles.Products.offer_id].

Después de insertar, actualizar o borrar la entrada de un producto, pueden pasar varios minutos antes de que se pueda recuperar el producto procesado.

Todos los campos de la entrada del producto y sus mensajes secundarios coinciden con el nombre en inglés del atributo correspondiente en la especificación de la vertical, con algunas excepciones.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

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}}"
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 el identificador único del producto. Esto es lo mismo para la entrada del producto y el producto procesado. Los espacios en blanco iniciales y finales se quitan y se reemplazan varios espacios en blanco al momento del envío. Consulta las especificaciones de datos de productos para obtener más detalles.
contentLanguage

string

Obligatorio. Inmutable. Corresponde al código de idioma ISO 639-1 de dos letras del producto.
feedLabel

string

Obligatorio. Inmutable. Es la etiqueta de feed del producto.
attributes

object (Attributes)

Opcional. Una lista de atributos de productos.
customAttributes[]

object (CustomAttribute)

Opcional. Una lista de atributos personalizados (proporcionados por el comercio). También se puede usar para enviar cualquier atributo de las especificaciones de datos en su formato genérico (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 permitida de caracteres para cada atributo personalizado es de 10,240 (representa la suma de caracteres para el nombre y el valor). Se puede configurar 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 (actualidad) del producto, que se puede usar para mantener el orden correcto cuando se realizan varias actualizaciones al mismo tiempo.

Si se establece, no se podrá insertar cuando el número de versión sea inferior al número de versión actual del producto existente. La reinserción (por ejemplo, actualizar el producto después de 30 días) se puede realizar con el versionNumber actual.

Solo es compatible con las inserciones en fuentes de datos principales.

Si se impide la operación, se arrojará la excepción anulada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta la descripción general de OAuth 2.0.