Merchant API 總覽

本頁將介紹 Merchant API，並說明您如何使用這個 API 自動化處理 Merchant Center 中管理帳戶、產品和廣告空間的各種工作流程。

您可以使用 Merchant API 觸及更多消費者，並在各項 Google 服務中展示產品。您可以使用 Merchant API 管理大型或複雜的 Merchant Center 帳戶。一些常見用途包括：

  • 自動管理帳戶
  • 自動化產品管理
  • 自動化商品目錄管理
  • 自訂報表

Merchant API 可讓您建立及管理多個資料來源，更妥善組織產品、促銷活動和評論的相關資訊。使用 Merchant API 時，您管理產品的方式與其他產品資料上傳方法 (例如檔案和 autofeed) 相輔相成。Merchant API 也可讓您平行執行多項個別要求。

Merchant API 是 Content API for Shopping 的重新設計，由多個子 API 組成。

零售商必須負責遵守購物廣告和免費產品資訊政策。Google 購物有權強制執行這些政策，並在發現違反這些政策的內容或行為時採取適當回應。

Merchant API 新功能

升級至 Merchant API 的理由如下：

詳情請參閱 Merchant API Beta 版的新功能。

事前準備

如要執行 Merchant API 要求，您必須具備下列項目：

  • Merchant Center 帳戶：您要查詢、更新及上傳資料的帳戶。請確認您具備必要的權限，可管理這個帳戶中的產品和廣告空間。

  • Google Cloud 專案：專案可用於取得帳戶的 API 存取權。

透過商家 API 進行驗證

您可以使用下列驗證選項：

  • 您可以為應用程式產生 OAuth 2.0 用戶端 ID 與密鑰。接下來，該 ID 和密鑰就能用來產生向 Merchant Center 帳戶發出 API 呼叫所需的 OAuth 2.0 憑證。
  • 您可以建立服務帳戶，並下載其私密金鑰以發出 API 呼叫。

帳戶和產品 ID

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

要求網址格式

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

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

針對清單和 get 等標準方法，系統會省略 :{METHOD} 部分。

舉例來說，下列要求會刪除區域性商品目錄資料：

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

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

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

舉例來說，下列要求顯示如何為 accounts/123456 建立區域：

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

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

開始使用 Merchant API

如要快速瞭解 Merchant API 的運作方式並嘗試上傳範例產品，請參閱開始使用 Merchant API 一文。

使用 gRPC 或 REST

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

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

使用用戶端程式庫和程式碼範例

每個子 API 都有用戶端程式庫可協助您順利上手。程式碼範例可協助您開始以 Java、PHP 和 Python 編寫程式碼。詳情請參閱 Merchant API 範例。

取得說明

如需支援資源，請參閱取得 Merchant API 相關說明。

提供意見

在 Beta 版測試期間，我們有機會在正式發布前收集並解決您的意見回饋。如要提供意見回饋，請提交下列其中一種做法：

  • API 功能：請提交意見回饋表單
  • 說明文件：使用網頁內縮圖評分和提供意見按鈕。
  • 範例和程式庫：在 GitHub 存放區上針對程式碼範例建立問題。

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

後續步驟

  • 如需回溯相容性的相關資訊，請參閱 Content API for Shopping 相容性。

  • 如要進一步瞭解 Merchant API 的主要功能，請參閱左側導覽選單中的指南。

  • 如需可用資源與服務的相關資訊，請參閱參考說明文件。

下一頁
Design