您可以使用 Merchant API 與 Google 分享商品目錄、商店和銷售資料，以獲得更多資訊及管理。
新功能
除了 Content API 功能外，Merchant API 還提供下列新功能：
- 擷取與本地動態饋給合作夥伴整合相關的賣家層級資源狀態的方法
- 傳送通知給零售商的方法
如要進一步瞭解這些方法，請參閱店面動態饋給合作夥伴 API 一文。
要求
請使用以下要求網址格式，針對當地動態饋給合作夥伴 API：
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
詳情請參閱「方法：accounts.lfpInventories.insert」。
以下是插入商品目錄要求的 Content API for Shopping 與本地動態饋給合作夥伴 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
|
| ID |
{merchantId}/pos/{targetMerchantId}
|
{parent} |
以下是插入銷售要求的 Content API for Shopping 與本地動態饋給合作夥伴 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 |
| ID | {merchantId}/pos/{targetMerchantId} |
{parent} |
以下比較內容 API for Shopping 與本地動態饋給合作夥伴 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 |
| ID | {merchantId}/pos/{targetMerchantId} |
{parent} |
方法
以下是店面動態饋給合作夥伴 API 中的商店 API 方法異動內容：
| 方法 | Content API for Shopping 中的網址 | Merchant API 中的網址 | Content API for Shopping 中的 ID | Merchant API 中的 ID | 說明 |
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} |
以下是店面動態饋給合作夥伴 API 中商品目錄 API 方法的異動內容：
| 方法 | Content API for Shopping 中的網址 | Merchant API 中的網址 | Content API for Shopping 中的 ID | Merchant API 中的 ID | 說明 |
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} |
以下是本地動態饋給合作夥伴 API 中銷售 API 方法的異動內容：
| 方法 | Content API for Shopping 中的網址 | Merchant API 中的網址 | Content API for Shopping 中的 ID | Merchant API 中的 ID | 說明 |
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} |
資源
以下是本地動態饋給合作夥伴 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 |
不支援 | 店面動態饋給合作夥伴 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 |
不支援 | 本地動態饋給合作夥伴 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 |
不支援 | 本地動態饋給合作夥伴 API 不支援 kind。 |