您可以參考本指南，整合 Merchant API 與 您現有的 Content API for Shopping 實作項目。
開始使用
如要進一步瞭解 Merchant API 設計，請參閱 商家 API 及其子 API
如要開始使用 Merchant API，請將要求網址變更為下列網址 格式：
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
請參閱快速入門指南和 請參閱 Merchant Center 的參考資料。
gRPC 支援
Merchant API 支援 gRPC 和 REST。別擔心！您可以使用 Merchant API 的 gRPC 和 Content API for Shopping 的 REST 讓應用程式從可以最快做出回應的位置 回應使用者要求
Merchant API 用戶端程式庫需要使用 gRPC。
詳情請參閱使用 gRPC 可能不準確或不適當
相容性
本指南說明適用於整個 Merchant API 的一般變更。詳情請見 下列指南瞭解特定功能的變更：
Merchant API 可與現有的 Content API for Shopping 搭配使用 v2.1 功能。
例如，您可以使用 Merchant Inventories API 和現有的
Content API for Shopping 2.1 版廣告空間和
products 實作。個人中心
可以使用 Content API for Shopping 上傳新的本機
產品 (也就是您銷售的
本地商店)，然後使用 Merchant Inventories API
LocalInventory敬上
資源，以便管理該產品的店內資訊。
批次要求
Merchant API 不支援 customBatch 方法中列出的
Content API for Shopping。請改為參閱「傳送批次」
要求。使用 customBatch，且
必須使用這項功能，才能在 Merchant API 中
意見回饋。
ID
為遵守 Google 的 API 改善原則，我們在 修改了 Merchant API 資源 ID
名稱會取代 ID
所有 Merchant API 資源都會使用 name 欄位做為專屬 ID。
以下範例說明如何在呼叫中使用 name 欄位：
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
系統會將這個新的 name 欄位做為所有讀取和讀取作業的資源 ID 傳回。
使用 Merchant API 寫入呼叫
name 欄位中傳回的值會使用新的 ID 格式。
舉例來說，實作 getName() 方法，從name
並將輸出內容儲存為變數，而非建構 name
以及自行輸入商家與資源 ID
新的 ID 格式
在 Merchant API 中，資源 ID 採用以下格式：
channel~language~feedLabel~offerId
Content API 資源在 ID 中的每個值間使用了 :，而不是 ~：
channel:language:feedLabel:offerId
所有 Merchant API 呼叫都會傳回新格式，~在
編號。我們建議您儲存回應中的新格式，並用於
的回呼。
子項資源的父項欄位
在 Merchant API 中，所有子項資源都有 parent 欄位。別擔心！您可以使用
parent 欄位，用於指定要插入子項的資源 name；
而不是傳遞整個父項資源您也可以使用 parent
欄位搭配 list 方法，列出該 parent 的子項資源。
舉例來說，如要列出某項產品的本地庫存，請指定
產品的 name
parent。
欄位
list
方法。在本例中，指定的 product 是parent
LocalInventory敬上
資源數量。
類型
以下列舉幾個 Merchant API 子 API 共用的常見類型。
價格
以下是商家 Common 套件中 Price 的變更：
| Content API | 商家 API | |
|---|---|---|
| 金額欄位 | value:string |
amountMicros:int64 |
| 幣別欄位 | currency:string
|
currencyCode:string |
Price 金額現已以微量記錄，其中 100 萬個微量
等同貨幣的標準單位
在 Content API for Shopping 中，Price 是以下數字的十進位數字：
字串。
金額欄位名稱已從「value」變更為「amountMicros」
貨幣欄位名稱已從「currency」變更為「currencyCode」。
格式仍是 ISO 4217。