En esta página, se explica cómo puedes subir y administrar tus productos de manera programática. Con la API de Merchant Products, puedes insertar o actualizar un producto en una fuente de datos, recuperarlo de tu cuenta y borrarlo de una fuente de datos.
Puedes usar el recurso products para crear un catálogo de tienda en línea, que es una lista de productos que están disponibles en los anuncios de Shopping. Puedes usar el recurso products una vez que hayas creado tu cuenta de Merchant Center y esté todo listo para subir un conjunto inicial de productos a través de la API.
Eres responsable de cumplir con las políticas de anuncios de Shopping y fichas gratuitas. Los anuncios de Shopping se reservan el derecho de aplicar estas políticas y de responder de forma apropiada si encontramos contenido o comportamiento que las incumpla.
El recurso products sube la información del producto a la base de datos de Shopping Merchant Center. También proporciona una serie de métodos que te permiten acceder, actualizar o borrar información del producto de a uno o muchos a la vez en el modo por lotes.
El recurso productInput representa los datos de entrada que envías para un producto. Un recurso productInput debe tener los siguientes campos:
channel: Es el canal del producto.offerId: Es el identificador único del producto. Este valor es el mismo para la entrada de producto y el producto procesado.contentLanguage: Es el código de idioma ISO 639-1 de dos letras del producto.feedLabel: Es la etiqueta de feed del producto.
Aunque los comercios pueden cargar productos con un archivo llamado feed principal, 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 varios productos en tiempo real, sin necesidad de administrar varios feeds complementarios. Los cambios en los productos que realizan las llamadas a la API pueden tardar varias horas en aparecer en la base de datos de Shopping Merchant Center.
Google puede ayudarte a mantener ciertos atributos de tus productos automáticamente. Para obtener más información, consulta Habilita las mejoras automáticas.
Requisitos previos
Si no tienes una fuente de datos, crea una con la API de fuentes de datos de Merchant Center 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 a fin de comprender cómo comenzar a usar la API de Merchant Products.
Cómo subir 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 para insertar un producto con la API de Merchant Products.
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.
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. Debes pasar el identificador único de la fuente de datos principal o complementaria a la que pertenece el producto para borrar un producto con la API de Merchant Products.
Muestra productos de tu cuenta
Para indicar todos los productos procesados en tu cuenta, usa el método
accounts.products.list.