Merchant API 總覽

你可以使用 Merchant API

• 管理商家和產品在 Google 上的顯示方式。
• 透過程式輔助方式存取資料、洞察資訊和獨特功能。
• 拓展業務，在 Google 上觸及更多顧客。

Merchant API 可管理大型或複雜的 Merchant Center 帳戶。 常見用途包括：

• 自動化帳戶管理
• 自動化產品管理
• 自動化商品目錄管理
• 自動管理成效和市場洞察報表

Merchant API 可讓您建立及管理多個資料來源，更妥善地整理產品、促銷活動和評論的相關資訊。使用 Merchant API 管理產品，可與其他產品資料上傳方式 (例如檔案和自動動態饋給) 搭配使用。Merchant API 也可讓你並行執行多個個別要求。

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

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

Merchant API 新功能

升級至 Merchant API 的原因如下：

• 推出下列新方法，更妥善管理商品目錄資料：

  • accounts.products.localInventories.delete
  • accounts.products.localInventories.list
  • accounts.products.regionalInventories.delete
  • accounts.products.regionalInventories.list

• 可建立及擷取補充資料來源，並將補充資料來源連結至主要資料來源，藉此管理補充資料來源。

• 啟用產品和帳戶異動推播通知，在資料異動時即時通知您，不必定期擷取資料。

• 介紹 accounts.autofeedSettings 資源，以及擷取和更新自動動態饋給設定的方法。

• 介紹如何上傳產品評論和商家評論。

• 推出 accounts.productInputs 資源，簡化 accounts.products 資源。

• 可搭配檔案等其他資料上傳方法，更新產品資料。

• 新增 NonProductPerformanceView 表格，用於存放非產品成效資料，例如零售商網站的連入流量資訊

• 模組化設計，功能改善更頻繁且獨立

• 更新說明文件和程式碼範例

• 更符合 Google 的 API 改進提案

• 透過開發人員註冊，為開發人員提供更完善的支援和溝通管道。

事前準備

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

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

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

• Merchant Center 帳戶與 Google Cloud 雲端專案之間的連結。呼叫開發人員註冊方法來建立連結。我們會透過這個帳戶和這些使用者，與您聯絡 API 整合、問卷調查和商機等事宜。

注意： 如果您是合作夥伴，但沒有 Merchant Center 帳戶，則需要建立並設定商家帳戶，包括新增至少一位 API 開發人員使用者，也就是負責整合的主要人員。

• 註冊為開發人員，將 Merchant Center 帳戶連結至 Google Cloud 雲端專案。具備 API 開發人員角色的使用者會收到 API 通訊內容，包括服務公告、開發人員問卷調查和商機。

注意： 如果您是合作夥伴，但沒有 Merchant Center 帳戶，則需要建立及設定商家帳戶，包括在註冊程序中新增至少一位 API 開發人員使用者，主要負責整合。

使用 Merchant API 進行驗證

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

• 您可以為應用程式產生 OAuth 2.0 用戶端 ID 和密鑰，然後使用這些資訊產生 OAuth 2.0 憑證，以便在 API 呼叫中用於 Merchant Center 帳戶。
• 您可以建立服務帳戶並下載私密金鑰，以便發出 API 呼叫。

帳戶和產品 ID

Merchant API 使用資源名稱而非 ID 進行識別。產品的資源名稱範例為 accounts/123456/products/en~US~sku123，其中 123456 是帳戶的專屬 ID，en~US~sku123 則是產品的專屬 ID。

要求網址格式

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

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

如果是 list 和 get 等標準方法，則會省略 :{METHOD} 部分。

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

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/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/v1/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 物件。 解讀結果。

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

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

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

取得說明

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

提供意見

如要提供意見，請提交下列其中一項：

• API 功能：在意見回饋表單的「What is the Issue/Question?」(問題/疑問為何？) 部分下方，選取「Send Feedback」(提供意見) 選項。
• 說明文件：使用網頁內的「喜歡/不喜歡」評分和「提供意見」按鈕。
• 範例和程式庫：在程式碼範例的 GitHub 存放區中建立問題。

後續步驟

• 如要瞭解回溯相容性，請參閱「Content API for Shopping 相容性」。

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

• 如要瞭解可用的資源和服務，請參閱參考文件。