Merchant API 總覽

本頁面將介紹 Merchant API，並說明如何使用該 API 自動化在 Merchant Center 中管理帳戶、產品和商品目錄的各種工作流程。

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

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

Merchant API 可讓您建立及管理多個資料來源，以便更有效率地整理產品、促銷活動和評論相關資訊。透過 Merchant API，你可以以補足其他產品資料上傳方式 (例如檔案和自動動態饋給) 的方式管理產品。

Merchant API 是 Content API for Shopping 的重新設計，包含多個 子 API。

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

Merchant API 的新功能

以下列舉升級至 Merchant API 的幾個原因：

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

事前準備

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

  • Merchant Center 帳戶：這是你要查詢、更新及上傳資料的帳戶。請確認你具備管理這個帳戶中產品和商品目錄的必要權限。

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

透過 Merchant 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 存放區的程式碼範例中建立問題。

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

後續步驟

下一頁
設計