你可以使用 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
|
| ID |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
以下是插入銷售要求的 Content API for Shopping 與本地動態饋給合作夥伴 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 |
| ID | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
以下是插入商店要求的 Content API for Shopping 與本地動態饋給合作夥伴 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 |
| ID | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
方法
以下是店面動態饋給合作夥伴 API 中的商店 API 方法異動內容：
| 方法 | Content API for Shopping 中的網址 | 商家 API 中的網址 | Content API for Shopping 中的 ID | Merchant API 中的 ID | 說明 |
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} |
以下是店面動態饋給合作夥伴 API 中商品目錄 API 方法的異動內容：
| 方法 | Content API for Shopping 中的網址 | 商家 API 中的網址 | Content API for Shopping 中的 ID | Merchant API 中的 ID | 說明 |
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} |
以下是本地動態饋給合作夥伴 API 中銷售 API 方法的異動內容：
| 方法 | Content API for Shopping 中的網址 | 商家 API 中的網址 | Content API for Shopping 中的 ID | Merchant API 中的 ID | 說明 |
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} |
資源
以下是本地動態饋給合作夥伴 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。 |