Importante: Content API for Shopping se desactivó el 18 de agosto de 2026.

A partir del 1 de septiembre de 2026, las solicitudes de Content API for Shopping experimentarán errores progresivos. Consulta la guía de desactivación de Content API.

Si necesitas más tiempo para migrar a la API de Merchant, solicita acceso extendido a Content API for Shopping.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Descripción general de la API de Merchant

Puedes usar la API de Merchant para lo siguiente:

Administra cómo aparecen tu empresa y tus productos en Google.
Obtén acceso programático a datos, estadísticas y funciones exclusivas.
Expande tu empresa y llega a más clientes en Google.

La API de Merchant puede administrar cuentas grandes o complejas de Merchant Center. Entre los casos de uso típicos, se incluyen los siguientes:

Administración automatizada de cuentas
Administración automatizada de productos
Administración automatizada del inventario
Administración automatizada de informes sobre rendimiento y estadísticas de mercado

La API de Merchant te permite crear y administrar varias fuentes de datos, con lo que puedes organizar mejor la información sobre productos, promociones y opiniones. Con la API de Merchant, puedes administrar productos de una manera que complemente otros métodos de carga de datos de productos, como archivos y feed automático. La API de Merchant también te permite ejecutar varias solicitudes individuales en paralelo.

La API de Merchant es un rediseño de la Content API for Shopping. Incluye varias sub-APIs.

Novedades de la API de Merchant

Estos son algunos de los motivos para actualizar a la API de Merchant:

Mejor administración de los datos de inventarios con la introducción de los siguientes métodos nuevos:
Permite administrar las fuentes de datos complementarias a través de su creación y recuperación, y vinculándolas a las fuentes de datos principales.
Habilita las notificaciones push para los cambios en los productos y las cuentas, lo que elimina la necesidad de realizar recuperaciones periódicas, ya que te notifica en tiempo real cuando cambian los datos.
Presenta el recurso accounts.autofeedSettings y los métodos para recuperar y actualizar la configuración de autofeed.
Se presenta la carga de opiniones sobre productos y opiniones sobre comercios.
Se introduce el recurso accounts.productInputs para simplificar el recurso accounts.products.
Permite actualizar los datos de productos junto con otros métodos de carga de datos, como los archivos.
Nueva tabla NonProductPerformanceView para datos de rendimiento que no son de productos, como información sobre el tráfico entrante al sitio web de un comercio
Diseño modular con mejoras de funciones aisladas y más frecuentes
Se actualizaron la documentación y las muestras de código.
Mejor alineación con las propuestas de mejora de la API de Google
Mejoramos la asistencia y la comunicación para los desarrolladores a través del Registro de desarrolladores.

Antes de comenzar

Para ejecutar una solicitud a la API de Merchant, debes tener lo siguiente:

Una cuenta de Merchant Center: Esta es la cuenta en la que consultarás, actualizarás y subirás datos. Asegúrate de tener los permisos necesarios para administrar productos e inventarios en esta cuenta.
Un proyecto de Google Cloud: Usa el proyecto para obtener acceso a la API de tu cuenta.
Una vinculación de tu cuenta de Merchant Center al proyecto de Google Cloud Crea el vínculo llamando al método de registro de desarrolladores. Usarás esta cuenta y estos usuarios para las comunicaciones relacionadas con la integración de la API, las encuestas y las oportunidades.

Vincula tu cuenta de Merchant Center al proyecto de Google Cloud registrándote como desarrollador. Los usuarios con el rol de desarrollador de APIs recibirán comunicaciones sobre la API, incluidos los anuncios obligatorios del servicio, las encuestas para desarrolladores y las oportunidades.

Autenticación con la API de Merchant

Puedes usar las siguientes opciones para la autenticación:

Puedes generar un ID de cliente y un secreto de OAuth 2.0 para tu app. Luego, puedes usar el ID y el secreto para generar las credenciales de OAuth 2.0 que se necesitan en las llamadas a la API a la cuenta de Merchant Center.
Puedes crear una cuenta de servicio y descargar su clave privada para realizar llamadas a la API.

Identificadores de cuenta y de producto

La API de Merchant usa nombres de recursos en lugar de IDs para la identificación. Un ejemplo de nombre de recurso para un producto puede ser accounts/123456/products/en~US~sku123, en el que 123456 es el identificador único de la cuenta y en~US~sku123 es el identificador único del producto.

Formato de la URL de solicitud

Para operar en un recurso, envía solicitudes a las URLs con el siguiente formato:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

La parte :{METHOD} se omite para los métodos estándar, como list y get.

Por ejemplo, la siguiente solicitud borra el inventario regional:

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/en~US~sku123/regionalInventories/456

Para crear un recurso, usa el nombre del recurso del recurso superior y esta URL:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Por ejemplo, en la siguiente solicitud, se muestra cómo puedes crear una región para accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Para obtener más detalles sobre servicios específicos, consulta la documentación de referencia de la API de Merchant.

Comienza a usar la API de Merchant

Para ver rápidamente cómo funciona la API de Merchant y probar subir un producto de ejemplo, consulta Comienza a usar la API de Merchant.

Usa gRPC o REST

La API de Merchant admite gRPC y REST. Estas son las dos formas de realizar llamadas a la API de Merchant:

gRPC (recomendado)	REST
Crea el cuerpo de la solicitud como un búfer de protocolo. Envía el cuerpo de la solicitud al servidor con HTTP/2. Deserializa la respuesta a un búfer de protocolo. Interpreta los resultados.	Crea el cuerpo de la solicitud como un objeto JSON. Envíala al servidor con HTTP 1.1. Deserializa la respuesta como un objeto JSON. Interpreta los resultados.

Usa bibliotecas cliente y muestras de código

Cada sub-API tiene bibliotecas cliente para ayudarte a comenzar. Las muestras de código pueden ayudarte a comenzar a escribir código en Java, PHP y Python. Para obtener más información, consulta Ejemplos de la API de Merchant.

Obtener ayuda

Para obtener información sobre cómo recibir asistencia, consulta Obtén ayuda con la API de Merchant.

Enviar comentarios

Para enviar comentarios, envía uno de los siguientes:

Funciones de la API: Selecciona la opción Enviar comentarios en la sección ¿Cuál es el problema o la pregunta? del formulario de comentarios.
Documentación: Usa las calificaciones con pulgares hacia arriba o hacia abajo de la página y el botón Enviar comentarios.
Muestras y bibliotecas: Crea un problema en el repositorio de GitHub para las muestras de código.

¿Qué sigue?

Para obtener información sobre la retrocompatibilidad, consulta Compatibilidad de Content API for Shopping.
Para obtener más información sobre las funciones clave de la API de Merchant, consulta las guías en el menú de navegación de la izquierda.
Para obtener información sobre los recursos y servicios disponibles, consulta la documentación de referencia.

Merchant API terms and conditions