本頁面由 Cloud Translation API 翻譯而成。

Merchant API 總覽

本頁面將介紹 Merchant API，並說明如何使用這項 API，自動執行與管理 Merchant Center 帳戶、產品和目錄相關的各種工作流程。

你可以使用 Merchant API 觸及更多顧客，並在 Google 各平台上展示產品。你可以使用 Merchant API 管理大型或複雜的 Merchant Center 帳戶。常見用途包括：

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

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

Merchant API 是 Content API for Shopping 的重新設計版本。其中包含多個子 API。

Merchant API 最新消息

升級至 Merchant API 的好處如下：

我們推出下列新方法，協助你更有效管理商品目錄資料：
可透過建立及擷取補充資料來源，以及將補充資料來源連結至主要資料來源，管理補充資料來源。
啟用產品資料變更通知，在產品狀態變更時通知你，不必定期擷取資料。
介紹 accounts.autofeedSettings 資源和方法，用於擷取及更新自動饋給設定。
推出上傳產品評論和商家評論功能。
推出 accounts.productInputs 資源，簡化 accounts.products 資源。
可搭配其他資料上傳方法 (例如檔案) 更新產品資料。
新的NonProductPerformanceView表格，用於非產品成效資料，例如零售商網站的來店流量資訊。
模組化設計，可更頻繁地改善功能。
與 Google 的 API 改進提案更一致。
更新說明文件和程式碼範例。
透過開發人員註冊，為開發人員提供更完善的支援和溝通管道。

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

事前準備

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

Merchant Center 帳戶：您將查詢、更新及上傳資料至這個帳戶。請確認您具備管理這個帳戶中產品和商品目錄的必要權限。
Google Cloud 專案：這個專案用於取得帳戶的 API 存取權。
呼叫開發人員註冊方法，將 Merchant Center 帳戶連結至 Google Cloud 專案。連結帳戶的使用者會收到 API 通訊內容，包括重大服務公告、開發人員問卷調查和商機。

使用 Merchant API 進行驗證

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

您可以為應用程式產生 OAuth 2.0 用戶端 ID 和密鑰。接著，您可以使用 ID 和密鑰產生 OAuth 2.0 憑證，在 API 呼叫中使用，存取 Merchant Center 帳戶。
您可以建立服務帳戶，並下載其私密金鑰來發出 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}

對於清單和取得等標準方法，會省略 :{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
以通訊協定緩衝區的形式建立要求主體。使用 HTTP/2 將要求主體傳送至伺服器。將回應反序列化為通訊協定緩衝區。解讀結果。	以 JSON 物件形式建立要求主體。使用 HTTP 1.1 將其傳送至伺服器。將回應還原序列化為 JSON 物件。解讀結果。

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

每個子 API 都有用戶端程式庫，可協助您開始使用。程式碼範例可協助您開始使用 Java、PHP 和 Python 編寫程式碼。詳情請參閱商家 API 範例。

取得說明

如要瞭解如何取得支援，請參閱「取得 Merchant API 相關協助」。

提供意見

在 Beta 版測試期間，我們有機會收集並處理您的意見回饋，如要提供意見，請提交下列其中一項：

API 功能：提交意見回饋表單
說明文件：使用頁面上的拇指評分和「提供意見」按鈕。
範例和程式庫：在程式碼範例的 GitHub 存放區建立問題。

如要在完成每項工作後提供一般意見，請填寫意見表。

後續步驟

如要瞭解回溯相容性，請參閱 Content API for Shopping 相容性。
如要進一步瞭解 Merchant API 的主要功能，請參閱左側導覽選單中的指南。
如要瞭解可用的資源和服務，請參閱參考說明文件。

Latest updates

Design