Comienza a usar la API de Merchant

Habilita la API de Merchant en tu proyecto de Cloud para comenzar.

Sigue estos pasos para usar la API de Merchant Center:

Usar las bibliotecas cliente

La API de Merchant se compone de varias sub-APIs.

Cada sub-API tiene muestras de código y bibliotecas cliente para ayudarte a comenzar.

Si ya usas Content API for Shopping, consulta la compatibilidad de Content API for Shopping.

Envía solicitudes

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/123/products/online~en~US~sku123, en el que 123 es el identificador único de la cuenta y online~en~US~sku123 es el identificador único del producto.

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}

Nota: Se omite la parte :{METHOD} para los métodos estándar.

Por ejemplo, esta solicitud borrará el inventario regional:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/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, así es como se crea una región nueva para account/123:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

Consulta la documentación de referencia de la API de Merchant para obtener más detalles sobre servicios específicos.

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
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íalo al servidor con HTTP 1.1. Deserializa la respuesta como un objeto JSON. Interpreta los resultados.

Nota: Si usas una biblioteca cliente, el mecanismo de transporte predeterminado es gRPC. En la mayoría de los casos, no necesitas hacer nada más que llamar a los extremos de la API de Merchant para usar gRPC.

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: Usa el botón New issue en GitHub.

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