Merchant API 設計

我們設計 Merchant API 時,考量到要讓 Content API for Shopping 開發人員感到熟悉, 同時更簡單且更具彈性。以下是 Merchant API 設計的詳細資訊。

子 API

商家 API 是一組子 API,子 API 是相關服務和資源的群組。也就是說,您可以選擇只使用特定整合作業所需的子 API。

Merchant API 包含下列子 API:

  • 帳戶:大規模管理 Merchant Center 帳戶。
  • 產品:管理產品資料,例如價格和供應情形。
  • 資料來源:查看及管理產品的資料來源。
  • 商品目錄在 Google 上依商店或區域展示產品。
  • 報表查看 Google 上的產品、成效和競爭環境資料。
  • 促銷活動:建立及管理促銷活動,展示產品的特價優惠。
  • 店面動態饋給合作夥伴: 上傳店面商品目錄動態饋給。
  • 轉換來源: 管理帳戶的轉換來源。
  • 通知:管理通知訂閱項目。
  • 配額:查看帳戶的 API 配額。

運輸

Merchant API 的預設傳輸機制為 gRPC。您也可以使用 REST

詳情請參閱快速入門指南

列舉

Merchant API 中的列舉欄位日後可能會公開新值。程式碼的結構應能妥善處理無法辨識的值。您應監控無法辨識的列舉值,並介入處理,確保程式碼維持最新狀態。

版本管理

子 API 會分開進行版本管理。也就是說,如果我們更新您未使用的子 API,您就不必採取任何行動。只有在您使用的子 API 發布新版本時,才需要更新程式碼。詳情請參閱「版本管理」。

結尾為「beta」的版本可能會變更或移除。