Migrate local feeds partnership

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: {

object (Price)

}

price: {

object (Price)

}

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: {

object (Price)

}

price: {

object (Price)

}

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.