Descripción general de la API de Merchant

En esta página, se proporciona una introducción a la API de Merchant 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 para administrar cuentas de Merchant Center grandes o complejas. Estos son algunos casos de uso típicos:

  • Administración automatizada de cuentas
  • 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, puedes administrar los productos de una manera que complementa otros métodos de carga de datos de productos, como los archivos y el 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. Comprende varias sub-APIs.

Novedades de la API de Merchant

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

Para obtener más información, consulta Nuevas funciones introducidas en la versión beta de 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 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.

  • Vincula tu cuenta de Merchant Center al proyecto de Google Cloud llamando al método Developer Registration. Los usuarios de la cuenta vinculada recibirán comunicaciones de la API, incluidos anuncios obligatorios del servicio, encuestas para desarrolladores y oportunidades.

Autenticación con la API de Merchant

Puedes usar las siguientes opciones para la autenticación:

  • Puedes generar un ID y un secreto de cliente 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 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 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, donde 123456 es el identificador único de la cuenta y online~en~US~sku123 es el identificador único del 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}

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, puedes usar el nombre del recurso del recurso principal 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 crear una región 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 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 en un búfer de protocolo.
  4. Interpreta los resultados.
  1. Crea el cuerpo de la solicitud como un objeto JSON.
  2. Envía la solicitud 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

El período beta nos brinda la oportunidad de recopilar y abordar tus comentarios antes del lanzamiento de la disponibilidad general. Para enviar comentarios, proporciona uno de los siguientes elementos:

  • Funciones de la API: Envía el formulario de comentarios
  • Documentación: Usa las calificaciones con pulgares 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 proporcionar comentarios generales después de implementar cada tarea, usa el formulario de comentarios.

¿Qué sigue?

  • Para obtener información sobre la compatibilidad con versiones anteriores, 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.

Anterior
Latest updates
Siguiente
Design