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 la La API de Merchant Center y sus subAPIs.
Para comenzar a usar la API de Merchant Center, cambia tus URLs de solicitud a lo siguiente: formato:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
Consulta la guía de inicio rápido y Consulta 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 tiempo.
Las bibliotecas cliente de la API de Merchant requieren gRPC.
Consulta cómo usar gRPC para obtener más información. 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 Center se diseñó para funcionar en conjunto con Content API for Shopping. v2.1.
Por ejemplo, puedes usar la API de Merchant Inventories junto con tu
Inventarios de la versión 2.1 de Content API for Shopping y
Implementación de products. Tú
podría usar Content API for Shopping para subir una nueva campaña local
producto (que vendes
en una tienda local) y, luego, usar la API de Merchant Inventories
LocalInventory
recurso 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 la
Content API for Shopping. En cambio, consulta Cómo enviar datos por lotes
solicitudes. Si usas customBatch
necesitas esta función para la API de Merchant Center, indica el motivo en tu
comentarios.
Identificadores
Para alinearnos con los principios de mejora de las APIs de Google, hemos hizo 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 recursos para todas las operaciones de lectura y
escribir llamadas 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
y almacena el resultado como una variable en lugar de construir el name
del comercio y de los IDs de recursos.
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 Center muestran el formato nuevo con ~ entre los valores de la
ID. Te recomendamos que almacenes el formato nuevo de la respuesta y lo uses en tu
futuras llamadas.
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 parent
con métodos list para enumerar los recursos secundarios de ese parent.
Por ejemplo, para enumerar los inventarios locales de un producto determinado, especifica el
la name del producto en la
parent
para la
list
. En este caso, el product proporcionado es el parent de la
LocalInventory
y los recursos 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 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 micros, donde 1 millón de micros es
equivalente a la unidad estándar de tu moneda.
En Content API for Shopping, Price era un número decimal en la forma de un
una cadena vacía.
El nombre del campo del importe cambió de value a amountMicros
El nombre del campo de moneda cambió de currency a currencyCode. El
sigue siendo ISO 4217.