You can use the Merchant API to share your inventories, stores, and sales data with Google for better visibility and management.
Requests
Use the following request URL format for the local feeds partnership API:
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
For more information, see Method: accounts.lfpInventories.insert.
Here's a sample comparison of the Content API for Shopping to the local feeds partnership API for the request to insert an inventory:
Content API | Merchant API | |
URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert
|
Identifiers |
{merchantId}/pos/ {targetMerchantId}
|
{parent} |
Here's a sample comparison of the Content API for Shopping to the local feeds partnership API for the request to insert a sale:
Content API | Merchant API | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpSales:insert |
Identifiers | {merchantId}/pos/ {targetMerchantId} |
{parent} |
Here's a sample comparison of the Content API for Shopping to the local feeds partnership API for the request to insert a store:
Content API | Merchant API | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpStores:insert |
Identifiers | {merchantId}/pos/ {targetMerchantId} |
{parent} |
Methods
Here's what changed for the store API methods in the local feeds partnership API:
Method | URL in Content API for Shopping | URL in Merchant API | Identifiers in Content API for Shopping | Identifiers in Merchant API | Description |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores:insert |
{merchantId}/pos /{targetMerchantId} |
{parent} | parent is in the format of accounts/{lfpPartnerAccountId} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
{name} | name is in the format of accounts/ {lfpPartnerAccountId}/lfpStores/ {targetMerchantId}~{storeCode} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
{name} | name is in the format of accounts/ {lfpPartnerAccountId}/lfpStores/ {targetMerchantId}~{storeCode} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores |
/{merchantId}/pos/ {targetMerchantId} |
{parent} | {parent} is in the format of accounts/ {lfpPartnerAccountId} |
Here's what changed for the inventory API methods in the local feeds partnership API:
Method | URL in Content API for Shopping | URL in Merchant API | Identifiers in Content API for Shopping | Identifiers in Merchant API | Description |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | parent is in the format of accounts/ {lfpPartnerAccountId} |
Here's what changed for the sales API methods in the local feeds partnership API:
Method | URL in Content API for Shopping | URL in Merchant API | Identifiers in Content API for Shopping | Identifiers in Merchant API | Description |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpSales:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | {parent} is in the format of accounts/ {lfpPartnerAccountId} |
Resources
Here's what has changed for the store resource in the local feeds partnership API. Fields not included here are unchanged.
Content API for Shopping | Merchant API | Description |
Not supported | name: string |
Added new field to differentiate different stores |
Not supported | targetAccount: integer |
The merchant account to insert inventories for |
targetCountry: string |
regionCode: string |
targetCountry has been renamed to regionCode |
websiteUrl: string |
websiteUri: string |
websiteUrl has been renamed to websiteUri |
kind: string |
Not supported | kind isn't supported in the local feeds partnership API |
Here's what has changed for inserting an inventory. Fields not included here are unchanged.
Content API for Shopping | Merchant API | Description |
Not supported | name: string |
Added new field to differentiate different inventories |
Not supported | targetAccount: integer |
The merchant account to insert inventories for. |
targetCountry: string |
regionCode: string |
targetCountry has been renamed to regionCode . The CLDR territory code for the country where the product is sold. |
itemId: string |
offerId: string |
itemId has been renamed to offerId |
quantity: string |
quantity: string |
quantity has been updated to be optional |
Not supported | availability: string |
availability is required |
|
|
Price definition has changed. For more information, see Price. |
timestamp: string |
collectionTime: string |
timestamp has been renamed to collectionTime |
kind: string |
Not supported | kind isn't supported in the local feeds partnership API. |
Here's what has changed for inserting a sale. Fields not included here are unchanged.
Content API for Shopping | Merchant API | Description |
Not supported | name: string |
Added new field to differentiate different inventories |
Not supported | targetAccount:integer |
The merchant account to insert sales for |
targetCountry: string |
regionCode: string |
The CLDR territory code for the country where the product is sold. |
itemId: string |
offerId: string |
itemId has been renamed to offerId |
|
|
Price definition has changed. For more information, see Price. |
timestamp: string |
saleTime: string |
timestamp has been renamed to saleTime |
kind: string |
Not supported | kind isn't supported in the local feeds partnership API. |