Merchant API 設計

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

子 API

Merchant API 是一組子 API。子 API 是相關服務和資源的群組。這項設計表示您可以選擇只使用特定整合作業所需的子 API。

Merchant API 包含下列子 API：

• 帳戶：大規模管理 Merchant Center 帳戶。
• 轉換： 管理帳戶的轉換來源。
• 資料來源：查看及管理產品的資料來源。
• 解決問題：找出影響帳戶的問題，並建立應用程式內診斷頁面。
• 商品目錄：在 Google 上依商店或區域展示產品。
• 店面動態饋給合作夥伴： 上傳店面商品目錄動態饋給。
• 通知：管理通知訂閱項目。
• 訂單追蹤：提供過往訂單追蹤資料，改善運送預估時間，並在產品資訊中顯示運送註解。
• 產品：管理產品資料，例如價格和供應情形。
• Product Studio：使用 Google Product Studio 自動生成產品圖片和文字建議。
• 促銷活動：建立及管理促銷活動，展示產品的特價優惠。
• Quota：查看帳戶的 API 配額。
• 報表：查看 Google 上的產品、成效和競爭環境資料。
• 評論：管理產品和賣家評論。

運輸

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

詳情請參閱快速入門指南。

列舉

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

版本管理

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

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

注意： 在 Merchant API Beta 版期間，我們可能會進行重大變更，但不會更新主要版本。我們會在重大變更前至少 30 天發送通知。在 Beta 版期間，所有子 API 都會維持在 v1beta 版。