- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
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 |
Obligatorio. La cuenta en la que se insertará este producto. Formato: cuentas/{account} |
Parámetros de consulta
Parámetros | |
---|---|
dataSource |
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: |
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 ( |
Campos | |
---|---|
name |
Identificador. Es el nombre de la entrada del producto. Formato: |
product |
Solo salida. Es el nombre del producto procesado. Formato: |
channel |
Obligatorio. Inmutable. Es el canal del producto. |
offerId |
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 |
Obligatorio. Inmutable. Corresponde al código de idioma ISO 639-1 de dos letras del producto. |
feedLabel |
Obligatorio. Inmutable. Es la etiqueta de feed del producto. |
attributes |
Opcional. Una lista de atributos de productos. |
customAttributes[] |
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, |
versionNumber |
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 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.