Descripción general de la API de Merchant

Puedes usar la API de Merchant para lo siguiente:

  • Administrar cómo aparecen tu empresa y tus productos en Google
  • Obtener acceso programático a datos, estadísticas y capacidades únicas
  • Expandir tu empresa y llegar a más clientes en Google

La API de Merchant puede administrar cuentas de Merchant Center grandes o complejas. Los casos prácticos más comunes incluyen los siguientes:

  • Administración automática de cuentas
  • Administración automática de productos
  • Administración automática del inventario
  • Administración automática de informes sobre el rendimiento y las estadísticas del 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 feeds automáticos. 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 motivos para actualizar a la API de Merchant:

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 cargará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.

  • Un vínculo de tu cuenta de Merchant Center al proyecto de Google Cloud. Para crear el vínculo, llama al método de registro de desarrolladores. Usarás esta cuenta y estos usuarios para la comunicación relacionada con la integración de la API, las encuestas y las oportunidades.

  • Para vincular tu cuenta de Merchant Center al proyecto de Google Cloud, regístrate como desarrollador. Los usuarios con el rol de desarrollador de la API 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, se pueden usar el ID y el secreto para generar las credenciales de OAuth 2.0 necesarias en las llamadas a la API de la cuenta de Merchant Center.
  • Puedes crear una cuenta de servicio y descargar su clave privada para realizar llamadas a la API.

Identificadores de cuentas y productos

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, donde 123456 es el identificador único de la cuenta y en~US~sku123 es el identificador único de el producto.

Formato de URL de solicitud

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

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

Se omite la parte :{METHOD} 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/online~en~US~sku123/regionalInventories/456

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

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

Por ejemplo, la siguiente solicitud 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 la carga de un producto de muestra, 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
  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 para 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

Para enviar comentarios, envía una de las siguientes opciones:

  • 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 de pulgar hacia arriba 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.

¿Qué sigue?

Anterior
Latest updates
Siguiente
Design