您可以使用 Merchant API 与 Google 共享商品目录、商店和销售数据，以便更好地了解和管理。
新功能
除了 Content API 功能之外，Merchant API 还提供了以下新功能：
- 用于检索与本地 Feed 合作伙伴集成相关的商家级媒体资源的状态的方法
- 一种向零售商发送通知的方法
如需详细了解这些方法，请参阅本地 Feed 合作伙伴关系 API。
请求
本地 Feed 合作伙伴 API 的请求网址格式如下：
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
如需了解详情，请参阅方法：accounts.lfpInventories.insert。
下面的示例比较了 Content API for Shopping 与本地 Feed 合作伙伴 API 在插入商品目录请求方面的差异：
| Content API | Merchant API | |
| 网址 |
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
|
| 标识符 |
{merchantId}/pos/{targetMerchantId}
|
{parent} |
以下是针对插入促销活动请求比较 Content API for Shopping 与本地 Feed 合作伙伴 API 的示例：
| Content API | Merchant API | |
| 网址 | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert |
| 标识符 | {merchantId}/pos/{targetMerchantId} |
{parent} |
以下是针对插入商店请求将 Content API for Shopping 与本地 Feed 合作伙伴 API 进行比较的示例：
| Content API | Merchant API | |
| 网址 | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpStores:insert |
| 标识符 | {merchantId}/pos/{targetMerchantId} |
{parent} |
方法
以下是本地 Feed 合作伙伴 API 中商店 API 方法的变更：
| 方法 | Content API for Shopping 中的网址 | Merchant API 中的网址 | Content API for Shopping 中的标识符 | Merchant API 中的标识符 | 说明 |
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”的格式为 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 的格式为 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 的格式为 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} 的格式为 accounts/{lfpPartnerAccountId} |
以下是本地 Feed 合作伙伴关系 API 中商品目录 API 方法的变更：
| 方法 | Content API for Shopping 中的网址 | Merchant API 中的网址 | Content API for Shopping 中的标识符 | Merchant API 中的标识符 | 说明 |
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 的格式为 accounts/{lfpPartnerAccountId} |
以下是本地 Feed 合作伙伴 API 中销售 API 方法的变更：
| 方法 | Content API for Shopping 中的网址 | Merchant API 中的网址 | Content API for Shopping 中的标识符 | Merchant API 中的标识符 | 说明 |
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} 的格式为 accounts/{lfpPartnerAccountId} |
资源
以下是本地 Feed 合作伙伴 API 中商店资源的更改。未包含在此处的字段未更改。
| Content API for Shopping | Merchant API | 说明 |
| 不支持 | name: string |
添加了新字段，以区分不同的商店 |
| 不支持 | targetAccount: integer |
要为其插入商品目录的商家账号 |
targetCountry: string |
regionCode: string |
已将 targetCountry 重命名为 regionCode |
websiteUrl: string |
websiteUri: string |
已将 websiteUrl 重命名为 websiteUri |
kind: string |
不支持 | 本地 Feed 合作伙伴 API 不支持 kind |
以下是有关插入商品目录的变更。未在此处列出的字段保持不变。
| Content API for Shopping | Merchant API | 说明 |
| 不支持 | name: string |
添加了新字段来区分不同的广告资源 |
| 不支持 | targetAccount: integer |
要为其插入商品目录的商家账号。 |
targetCountry: string |
regionCode: string |
targetCountry 已重命名为 regionCode。商品销往国家/地区的 CLDR 地区代码。 |
itemId: string |
offerId: string |
已将 itemId 重命名为 offerId |
quantity: string |
quantity: string |
quantity 已更新为可选项 |
| 不支持 | availability: string |
必须提供availability |
|
|
价格定义已更改。如需了解详情，请参阅价格。 |
timestamp: string |
collectionTime: string |
已将 timestamp 重命名为 collectionTime |
kind: string |
不支持 | 本地 Feed 合作伙伴 API 不支持 kind。 |
以下是关于插入促销活动的更改。未在此处列出的字段保持不变。
| Content API for Shopping | Merchant API | 说明 |
| 不支持 | name: string |
添加了新字段来区分不同的广告资源 |
| 不支持 | targetAccount:integer |
要为其插入销售信息的商家账号 |
targetCountry: string |
regionCode: string |
商品销往国家/地区的 CLDR 地区代码。 |
itemId: string |
offerId: string |
已将 itemId 重命名为 offerId |
|
|
价格定义已更改。如需了解详情，请参阅价格。 |
timestamp: string |
saleTime: string |
已将 timestamp 重命名为 saleTime |
kind: string |
不支持 | 本地 Feed 合作伙伴 API 不支持 kind。 |