您可以使用 Merchant API 与 Google 分享您的商品目录、实体店和销售数据，以便更好地查看和管理这些数据。
新功能
除了 Content API 功能之外，Merchant API 还提供以下新功能：
- 用于检索与本地 Feed 合作伙伴集成相关的商家级媒体资源的状态的方法
- 向零售商发送通知的方法
如需详细了解这些方法，请参阅 Local Feeds Partnership 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
|
| 标识符 |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
以下是针对插入促销活动请求比较 Content API for Shopping 与本地 Feed 合作伙伴 API 的示例：
| Content API | Merchant API | |
| 网址 | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert |
| 标识符 | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
以下是针对插入商店请求将 Content API for Shopping 与本地 Feed 合作伙伴 API 进行比较的示例：
| Content API | Merchant API | |
| 网址 | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert |
| 标识符 | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent 采用 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 的格式为 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 的格式为 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} 的格式为 accounts/{IFP_PARTNER_ACCOUNT_ID} |
以下是本地 Feed 合作伙伴关系 API 中商品目录 API 方法的变更：
| 方法 | Content API for Shopping 中的网址 | Merchant API 中的网址 | Content API for Shopping 中的标识符 | Merchant API 中的标识符 | 说明 |
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 的格式为 accounts/{IFP_PARTNER_ACCOUNT_ID} |
以下是本地 Feed 合作伙伴 API 中销售 API 方法的变更：
| 方法 | Content API for Shopping 中的网址 | Merchant API 中的网址 | Content API for Shopping 中的标识符 | Merchant API 中的标识符 | 说明 |
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} 的格式为 accounts/{IFP_PARTNER_ACCOUNT_ID} |
资源
以下是本地 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。 |