Puedes usar la API de Merchant para compartir tus inventarios, tiendas y datos de ventas con Google para mejorar la visibilidad y la administración.
Nuevas funciones
Además de las funciones de Content API, Merchant API ofrece las siguientes funciones nuevas:
- Método para recuperar el estado de las propiedades a nivel de la empresa relacionadas con la integración de socios de feeds locales
- Método para enviar una notificación a un comercio
Para obtener detalles sobre estos métodos, consulta la API de Local Feeds Partnership.
Solicitudes
Usa el siguiente formato de URL de solicitud para la API de la asociación de feeds locales:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Para obtener más información, consulta Método: accounts.lfpInventories.insert.
A continuación, se muestra una comparación de ejemplo entre la API de Content for Shopping y la API de asociación de feeds locales para la solicitud de inserción de un inventario:
Content API | API de Merchant | |
URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1/ {PARENT}/lfpInventories:insert
|
Identificadores |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}
|
{PARENT} |
A continuación, se muestra una comparación de ejemplo entre Content API for Shopping y la API de asociación de feeds locales para la solicitud de inserción de una oferta:
Content API | API de Merchant | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1/ {PARENT}/lfpSales:insert |
Identificadores | {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} |
A continuación, se muestra una comparación de ejemplo entre Content API for Shopping y la API de asociación de feeds locales para la solicitud de insertar una tienda:
Content API | API de Merchant | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/ {PARENT}/lfpStores:insert |
Identificadores | {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} |
Métodos
Estos son los cambios que se realizaron en los métodos de la API de la tienda en la API de la asociación de feeds locales:
Método | URL en Content API for Shopping | URL en la API de Merchant Center | Identificadores en Content API for Shopping | Identificadores en la API de Merchant | Descripción |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/ {parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos /{TARGETMERCHANT_ID} |
{PARENT} | parent tiene el formato accounts/{IFP_PARTNER_ACCOUNT_ID} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store/ {STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1/ {name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store/ {STORE_CODE} |
{NAME} | name tiene el formato accounts/ {IFP_PARTNER_ACCOUNT_ID}/lfpStores/ {TARGETMERCHANT_ID}~{STORE_CODE} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store/ {STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1/ {name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store/ {STORE_CODE} |
{NAME} | name tiene el formato accounts/ {IFP_PARTNER_ACCOUNT_ID}/lfpStores/ {TARGETMERCHANT_ID}~{STORE_CODE} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1/ {parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | {PARENT} tiene el formato accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Estos son los cambios que se realizaron en los métodos de la API de Inventory en la API de Local Feeds Partnership:
Método | URL en Content API for Shopping | URL en la API de Merchant Center | Identificadores en Content API for Shopping | Identificadores en la API de Merchant | Descripción |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/ {PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | parent tiene el formato accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Estos son los cambios que se realizaron en los métodos de la API de Sales en la API de Local Feeds Partnership:
Método | URL en Content API for Shopping | URL en la API de Merchant Center | Identificadores en Content API for Shopping | Identificadores en la API de Merchant | Descripción |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/ {PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | {PARENT} tiene el formato accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Recursos
Estos son los cambios que se realizaron en el recurso de la tienda en la API de la asociación de feeds locales. Los campos que no se incluyen aquí no se modifican.
Content API for Shopping | API de Merchant | Descripción |
No compatible | name: string |
Se agregó un campo nuevo para diferenciar las distintas tiendas |
No compatible | targetAccount: integer |
Cuenta de Merchant Center en la que se insertarán los inventarios |
targetCountry: string |
regionCode: string |
Se cambió el nombre de targetCountry por regionCode . |
websiteUrl: string |
websiteUri: string |
Se cambió el nombre de websiteUrl por websiteUri . |
kind: string |
No compatible | kind no se admite en la API de socios de feeds locales |
A continuación, se indican los cambios que se realizaron para insertar un inventario. Los campos que no se incluyen aquí no se modifican.
Content API for Shopping | API de Merchant | Descripción |
No compatible | name: string |
Se agregó un campo nuevo para diferenciar los distintos inventarios |
No compatible | targetAccount: integer |
Es la cuenta de Merchant Center en la que se insertarán los inventarios. |
targetCountry: string |
regionCode: string |
El nombre de targetCountry cambió por regionCode . Es el código de territorio de CLDR del país en el que se vende el producto. |
itemId: string |
offerId: string |
Se cambió el nombre de itemId por offerId . |
quantity: string |
quantity: string |
Se actualizó quantity para que sea opcional |
No compatible | availability: string |
availability es obligatorio |
|
|
Cambió la definición del precio. Para obtener más información, consulta Precio. |
timestamp: string |
collectionTime: string |
Se cambió el nombre de timestamp por collectionTime . |
kind: string |
No compatible | kind no se admite en la API de socios de feeds locales. |
A continuación, se indican los cambios para insertar una venta. Los campos que no se incluyen aquí no se modifican.
Content API for Shopping | API de Merchant | Descripción |
No compatible | name: string |
Se agregó un campo nuevo para diferenciar los distintos inventarios |
No compatible | targetAccount:integer |
Cuenta de Merchant Center en la que se insertarán las ventas |
targetCountry: string |
regionCode: string |
Es el código de territorio de CLDR del país en el que se vende el producto. |
itemId: string |
offerId: string |
Se cambió el nombre de itemId por offerId . |
|
|
Cambió la definición del precio. Para obtener más información, consulta Precio. |
timestamp: string |
saleTime: string |
Se cambió el nombre de timestamp por saleTime . |
kind: string |
No compatible | kind no se admite en la API de socios de feeds locales. |