Descripción general de la API de Merchant

En esta página, se proporciona una introducción a la API de Merchant Center y se explica cómo puedes usarla para automatizar varios flujos de trabajo relacionados con la administración de cuentas, productos e inventarios en Merchant Center.

Puedes usar la API de Merchant para llegar a más clientes y mostrar tus productos en Google. Puedes usar la API de Merchant Center para administrar cuentas grandes o complejas de esta plataforma. Estos son algunos casos de uso típicos:

  • Administración de cuentas automática
  • Administración de productos automatizada
  • Administración automatizada del inventario
  • Informes personalizados

La API de Merchant te permite crear y administrar varias fuentes de datos, lo que permite una mejor organización de la información sobre productos, promociones y opiniones. Con la API de Merchant Center, puedes administrar los productos de una manera que complemente otros métodos de carga de datos de productos, como los archivos y el feed automático.

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

Los minoristas son responsables de cumplir con las políticas de anuncios de Shopping y de fichas gratuitas. Google Shopping se reserva el derecho de aplicar estas políticas y responder de manera adecuada si se detecta contenido o comportamientos que las infrinjan.

Novedades de la API de Merchant

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

Para obtener más información, consulta Funciones nuevas que se presentan en la versión beta de la API de Merchant.

Antes de comenzar

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

  • Una cuenta de Merchant Center: Esta es la cuenta a la que consultarás, actualizarás y subirás datos. Asegúrate de tener los permisos necesarios para administrar los productos y los inventarios en esta cuenta.

  • Un proyecto de Google Cloud: El proyecto se usa para obtener acceso a la API de tu cuenta.

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, el ID y el secreto se pueden usar para generar las credenciales de OAuth 2.0 necesarias 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 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/online~en~US~sku123, en el que 123456 es el identificador único de la cuenta y online~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/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Para crear un recurso nuevo, puedes usar el nombre del recurso superior y la siguiente 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 nueva para accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1beta/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 maneras de realizar llamadas a la API de Merchant:

gRPC (recomendado) REST
  1. Crea el cuerpo de la solicitud como un búfer de protocolo.
  2. Envía el cuerpo de la solicitud al servidor con HTTP/2.
  3. Deserializa la respuesta a un búfer de protocolo.
  4. Interpreta los resultados.
  1. Crea el cuerpo de la solicitud como un objeto JSON.
  2. Envíalo al servidor con HTTP 1.1.
  3. Deserializa la respuesta como un objeto JSON.
  4. 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 obtener asistencia, consulta Obtén ayuda con la API de Merchant.

Enviar comentarios

El período beta nos brinda la oportunidad de recopilar y abordar tus comentarios antes de la versión de disponibilidad general. Para enviar comentarios, envía una de las siguientes opciones:

  • Funciones de la API: Envía el formulario de comentarios.
  • Documentación: Usa las miniaturas de calificación en 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.

Para enviar comentarios generales después de implementar cada tarea, usa el formulario de comentarios.

¿Qué sigue?

  • Para obtener información sobre la retrocompatibilidad, consulta la 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 del menú de navegación izquierdo.

  • Para obtener información sobre los recursos y servicios disponibles, consulta la documentación de referencia.

Siguiente
Diseño