Puedes usar la API de Merchant para compartir tus inventarios, tiendas y datos de ventas con Google y mejorar la visibilidad y la administración.
Nuevas funciones
Además de las funciones de Content API, Merchant API ofrece las siguientes funciones nuevas:
- Es un método para recuperar el estado de las propiedades a nivel del comercio relacionadas con la integración de socios de feeds locales.
- Un método para enviar una notificación a un minorista
Para obtener más información sobre estos métodos, consulta la API de la asociación de feeds locales.
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/v1beta/{PARENT}/lfpInventories:insert
Para obtener más información, consulta Método: accounts.lfpInventories.insert.
A continuación, se muestra una comparación de muestra de Content API for Shopping con la API de la asociación de feeds locales para la solicitud de inserción de un inventario:
Content API | API de Merchant Center | |
URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT}/lfpInventories:insert
|
Identificadores |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}
|
{PARENT} |
A continuación, se muestra una comparación de muestra de Content API for Shopping con la API de la asociación de feeds locales para la solicitud de insertar una venta:
Content API | API de Merchant Center | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT}/lfpSales:insert |
Identificadores | {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} |
A continuación, se muestra una comparación de muestra de Content API for Shopping con la API de la asociación de feeds locales para la solicitud de insertar una tienda:
Content API | API de Merchant Center | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT}/lfpStores:insert |
Identificadores | {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} |
Métodos
A continuación, se muestra lo que cambió para los métodos de la API de Store 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/v1beta/ {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/v1beta/ {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/v1beta/ {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/v1beta/ {parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | {PARENT} tiene el formato accounts/ {IFP_PARTNER_ACCOUNT_ID}. |
Estos son los cambios en los métodos de la API de inventario de 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/v1beta/ {PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | parent tiene el formato accounts/ {IFP_PARTNER_ACCOUNT_ID}. |
Estos son los cambios en los métodos de la API de ventas 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/v1beta/ {PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | {PARENT} tiene el formato accounts/ {IFP_PARTNER_ACCOUNT_ID}. |
Recursos
A continuación, se muestra lo que cambió para el recurso de 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 Center | Descripción |
No compatible | name: string |
Se agregó un campo nuevo para diferenciar las diferentes tiendas |
No compatible | targetAccount: integer |
La cuenta del comerciante para la que deseas insertar 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 es compatible con la API de la asociación de feeds locales. |
A continuación, te mostramos los cambios para insertar un inventario. Los campos que no se incluyen aquí no se modifican.
Content API for Shopping | API de Merchant Center | Descripción |
No compatible | name: string |
Se agregó un campo nuevo para diferenciar los diferentes inventarios |
No compatible | targetAccount: integer |
Es la cuenta del comercio para 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 es compatible con la API de la asociación de feeds locales. |
A continuación, te mostramos los cambios para insertar una venta. Los campos que no se incluyen aquí no se modifican.
Content API for Shopping | API de Merchant Center | Descripción |
No compatible | name: string |
Se agregó un campo nuevo para diferenciar los diferentes inventarios |
No compatible | targetAccount:integer |
La cuenta del comerciante para la que deseas insertar 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 es compatible con la API de la asociación de feeds locales. |