En esta página, se explica cómo puedes subir y administrar tus productos de forma programática. Con la API de Merchant Products, puedes insertar o actualizar un producto en una fuente de datos, recuperar un producto de tu cuenta y borrar un producto de una fuente de datos.
La API de Merchant Products contiene dos recursos.
productInputsrepresenta las partes de entrada de tus productos.productsrepresenta los productos procesados que se construyeron a partir de las partes de entrada.
productInputs puede ser principal y complementario, según si se sube a una fuente de datos principal o a una fuente de datos complementaria.
Cada product se construirá a partir de un solo productInput principal y cualquier cantidad de productInputs complementarios.
Puedes usar la API de Merchant Products para crear catálogos de tiendas en línea o locales, que son productos que pueden aparecer en varios destinos de compras.
Puedes usar el recurso productInputs una vez que hayas creado tu cuenta de Merchant Center, configurado tu primera fuente de datos y tengas todo listo para subir un conjunto inicial de productos a través de la API.
Si bien los comercios pueden subir productos con un archivo llamado PrimaryProductDataSource, existen varias ventajas de crear y borrar productos con la API de Merchant. Estas ventajas incluyen un tiempo de respuesta más rápido y la capacidad de actualizar productos en tiempo real, sin necesidad de administrar archivos grandes. Los cambios en los productos realizados a través de llamadas a la API pueden tardar hasta varias horas en aparecer en la base de datos de Shopping.
Requisitos previos
Si no tienes una fuente de datos, crea una con la API de Merchant DataSources o Merchant Center.
Si ya tienes una fuente de datos que creaste con la IU de Merchant Center o con la API, puedes usar la API de Merchant Products para agregar tus productos. Si usas Content API for Shopping para agregar productos, consulta la guía de migración para obtener información sobre cómo comenzar a usar la API de Merchant Products.
Usted es responsable de cumplir con las políticas de anuncios de Shopping y de fichas gratuitas. Anuncios de Shopping se reserva el derecho de aplicar estas políticas y responder de manera adecuada si detectamos contenido o comportamientos que las infrinjan.
Recursos
El recurso products te permite recuperar información de productos de la base de datos de Shopping.
El recurso productInput representa los datos de entrada que envías para un producto. También proporciona métodos que te permiten actualizar o borrar la información de los productos uno por uno o muchos a la vez en el modo por lotes. Un recurso productInput debe tener los siguientes campos:
channel: Es el canal del producto.offerId: Es el identificador único del producto.contentLanguage: Es el código de idioma ISO 639-1 de dos letras del producto.feedLabel: Es la etiqueta del feed del producto.
Sube una entrada de producto a tu cuenta
Para subir una entrada de producto a tu cuenta, usa el método accounts.productInputs.insert. Debes pasar el identificador único de la fuente de datos principal o complementaria.
Cómo recuperar un producto procesado de tu cuenta
Para recuperar un producto procesado de tu cuenta, usa el método accounts.products.get. El producto procesado puede tardar varios minutos en aparecer después de la inserción.
Puedes obtener el nombre del recurso del producto procesado del campo product en la respuesta de accounts.productInputs.insert.
Cómo borrar una entrada de producto de tu cuenta
Para borrar una entrada de producto de tu cuenta, usa el método accounts.productInputs.delete. Para borrar un producto con la API de Merchant Products, debes pasar el identificador único de la fuente de datos principal o complementaria a la que pertenece el producto.
Cómo mostrar una lista de productos de tu cuenta
Para enumerar los productos procesados en tu cuenta, usa el método accounts.products.list.