開始使用 Merchant API

請在Cloud 專案中啟用 Merchant API，即可開始使用。

商家 API 的使用方式如下：

使用用戶端程式庫

Merchant API 由多個子 API 組成。

每個子 API 都有程式碼範例和用戶端程式庫，協助您輕鬆上手。

如果您已使用 Content API for Shopping，請參閱 Content API for Shopping 相容性。

傳送要求

Merchant API 會使用「資源名稱」來識別身分，而不是使用 ID。產品的資源名稱範例為 accounts/123/products/online~en~US~sku123，其中 123 是帳戶的專屬 ID，online~en~US~sku123 則是產品的專屬 ID。

如要對資源執行操作，請使用下列格式將要求傳送至網址：

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}:{method}

注意： 標準方法會省略 :{method} 部分。

舉例來說，這項要求會刪除區域商品目錄：

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

如要建立新資源，您可以使用父項資源的資源名稱和以下網址

POST https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name of parent}/{resource}

例如，您可以透過以下方式為 account/123 建立新的區域

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

如要進一步瞭解特定服務，請參閱 Merchant API 參考說明文件。

使用 gRPC 或 REST

Merchant API 支援 gRPC 和 REST。以下是執行 Merchant API 呼叫的兩種方式：

gRPC (建議)	REST
將要求主體建立為通訊協定緩衝區。 使用 HTTP/2 將要求主體傳送至伺服器。 將通訊協定緩衝區的回應反序列化。 解讀結果。	將要求主體建立為 JSON 物件。 使用 HTTP 1.1 將其傳送至伺服器。 將回應反序列為 JSON 物件。 解讀結果。

注意： 如果您使用用戶端程式庫，預設傳輸機制為 gRPC。在大多數情況下，您只需呼叫 Merchant API 端點即可使用 gRPC。

取得說明

如需取得支援，請參閱「取得 Merchant API 相關協助」一文。

提供意見

在 Beta 版測試期間，我們將收集並回應您的意見回饋，以便在正式發行前解決問題。如要提供意見回饋，請提交下列其中一種內容：

• API 功能：請提交意見回饋表單
• 說明文件：使用頁面內的拇指評分和「提供意見」按鈕。
• 範例和程式庫：請使用 GitHub 上的「New issue」按鈕。

如要在執行每項工作後提供一般意見，請使用意見回饋表單。