Puedes usar esta guía para integrar la API de Merchant en tu implementación existente de Content API for Shopping.
Comenzar
Consulta el diseño de la API de Merchant para obtener detalles sobre esta y sus subAPIs.
Para comenzar a usar la API de Merchant Center, cambia las URLs de solicitud al siguiente formato:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
Consulta la guía de inicio rápido y la referencia de la API de Merchant Center para obtener más información.
Compatibilidad con gRPC
La API de Merchant Center admite gRPC y REST. Puedes usar gRPC para la API de Merchant Center y REST para Content API for Shopping al mismo tiempo.
Las bibliotecas cliente de la API de Merchant requieren gRPC.
Consulta cómo usar gRPC para obtener más información.
Compatibilidad
En esta guía, se describen los cambios generales que se aplican a toda la API de Merchant Center. Consulta las siguientes guías para conocer los cambios en funciones específicas:
- Cómo migrar la administración de cuentas
- Cómo migrar la configuración de envío
- Cómo migrar la administración de productos
- Cómo migrar la administración de fuentes de datos
- Cómo migrar la administración de inventarios
- Cómo migrar la administración de promociones
- Cómo migrar la administración de informes
- Cómo migrar la administración de las fuentes de conversiones
- Cómo migrar la administración de socios de feeds locales
La API de Merchant se diseñó para funcionar junto con las funciones existentes de Content API for Shopping v2.1.
Por ejemplo, puedes usar la API de Merchant Inventories junto con tus inventarios existentes de Content API for Shopping v2.1 y la implementación de products. Puedes usar Content API for Shopping para subir un producto local nuevo (que vendes en una tienda local) y, luego, usar el recurso de la API de Merchant Inventories LocalInventory para administrar la información en la tienda de ese producto.
Utiliza solicitudes por lotes
La API de Merchant no es compatible con el método customBatch que se muestra en Content API for Shopping. En su lugar, consulta Cómo enviar solicitudes por lotes. Si usas customBatch y
necesitas esta función para la API de Merchant Center, envíanos tus
comentarios para indicarnos el motivo.
Identificadores
Para alinearnos con los principios de mejora de la API de Google, realizamos algunos cambios en los identificadores de los recursos de la API de Merchant Center.
el nombre reemplaza al ID
Todos los recursos de la API de Merchant Center usan el campo name como identificador único.
Este es un ejemplo de cómo usar el campo name en las llamadas:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
Este nuevo campo name se muestra como el identificador de recurso para todas las llamadas de lectura y escritura en la API de Merchant Center.
El valor que se muestra en los campos name usa el nuevo formato de ID.
Por ejemplo, implementa un método getName() para recuperar el name de un recurso y almacena el resultado como una variable en lugar de construir el name desde los IDs del comercio y de los recursos por tu cuenta.
Nuevo formato de ID
En la API de Merchant Center, los IDs de recursos usan el siguiente formato:
channel~language~feedLabel~offerId
Los recursos de Content API usaron : en lugar de ~ entre cada valor del ID:
channel:language:feedLabel:offerId
Todas las llamadas a la API de Merchant muestran el formato nuevo con ~ entre los valores del ID. Te recomendamos que almacenes el formato nuevo de la respuesta y lo uses en tus llamadas futuras.
campos superiores para los recursos secundarios
En la API de Merchant Center, todos los recursos secundarios tienen el campo parent. Puedes usar el campo parent para especificar el name del recurso en el que se insertará el elemento secundario, en lugar de pasar todo el recurso superior. También puedes usar el campo parent con los métodos list para enumerar los recursos secundarios de ese parent.
Por ejemplo, para enumerar los inventarios locales de un producto determinado, especifica el name del producto en el campo parent del método list. En este caso, el product proporcionado es el parent de los recursos de LocalInventory que se muestran.
Tipos
Estos son algunos de los tipos comunes que se comparten entre las subAPIs de la API de Merchant Center.
Precio
A continuación, se muestran los cambios que se realizaron para Price en el paquete de Merchant Common:
| Content API | API de Merchant Center | |
|---|---|---|
| Campo del importe | value:string |
amountMicros:int64 |
| Campo de moneda | currency:string
|
currencyCode:string |
El importe de Price ahora se registra en microsegundos, donde 1 millón de micros equivale a la unidad estándar de tu moneda.
En Content API for Shopping, Price era un número decimal en forma de cadena.
El nombre del campo del importe cambió de value a amountMicros
El nombre del campo de moneda cambió de currency a currencyCode. El formato sigue siendo ISO 4217.