為 Merchant API 設定驗證

為確保資料安全性、強制執行存取控管,以及維護系統完整性,您必須驗證所有 Merchant API 要求。API 會根據通過驗證的身分,判斷呼叫端有權執行的動作。舉例來說,部分呼叫端可能只有產品資料的唯讀存取權,其他呼叫端則可修改 Merchant Center 中的帳戶設定。

本文件是 Merchant API 入門系列的一部分。如果您已透過 Merchant API 設定驗證,可以跳到下一節: 註冊為開發人員

授權對 Merchant API 的要求

傳送至 Merchant API 的每項要求都必須包含授權權杖,以便向 Google 識別您的應用程式。如要設定驗證和授權,請根據您打算使用 Merchant API 的方式,選擇最符合的用途:

您是否正在建構供其他商家使用的應用程式?

如果是,請使用 OAuth 2.0 授權。在下列情況下,請選擇 OAuth 2.0 授權:

  • 您是第三方供應商或代理商:您正在建構應用程式 (例如軟體即服務平台),供其他商家管理自己的 Merchant Center 資料。
  • 需要管理多個外部帳戶:您希望單一應用程式能跨多個獨立的 Merchant Center 帳戶運作,而這些帳戶分屬不同客戶。客戶只要登入自己的 Google 帳戶,並在同意畫面中點選「允許」,即可授予權限。

您是否正在為自己的商家建構應用程式?

如果是,請使用服務帳戶授權取得 Merchant API 存取權。 在下列情況下,請選擇服務帳戶授權:

  • 您正在建構自己的內部應用程式:您正在開發專為自家業務設計的工具,用於管理 Merchant Center 資料,或希望憑證屬於應用程式本身,而非特定個別使用者。
  • 需要自動化作業,不需人工登入:應用程式會執行背景工作,例如自動更新商品目錄或「cron」工作。

OAuth 2.0 授權

如果您是管理多個客戶帳戶的第三方供應商或代理商,應用程式必須使用 OAuth 2.0 對要求進行授權。請按照下列步驟,為 Merchant API 設定 OAuth 2.0:

  1. 在 Google Cloud 控制台的「API 和服務」中建立 OAuth 2.0 憑證
  2. 將 OAuth2 用戶端憑證下載至檔案,例如 client-secrets.json
  3. 將電子郵件帳戶新增為 Merchant Center 使用者:請確認用於授權要求的 Google 帳戶,已新增為 Merchant Center 使用者。詳情請參閱「如何在 Merchant Center 中新增或移除使用者」
  4. 指派 Admin 角色給該帳戶,以便執行註冊作業。如要進一步瞭解角色,請參閱「管理 Merchant Center 的使用者與存取層級」
  5. 使用程式碼範例設定驗證:請按照官方程式碼範例「設定驗證和範例設定」說明文件一節中的指引操作

如要進一步瞭解 OAuth 2.0 授權,請參閱「授權第三方應用程式存取 Merchant Center 帳戶」和「使用 OAuth 2.0 存取 Google API」。

服務帳戶授權

您可以使用服務帳戶,授權 Merchant API 存取自己的 Merchant Center 帳戶。請按照下列步驟,設定 Merchant API 的服務帳戶授權:

  1. 在 Google Cloud 控制台的「API 和服務」中建立服務帳戶憑證
  2. 下載私密金鑰:建立並下載服務帳戶的 JSON 格式私密金鑰。將檔案重新命名為 service-account.json
  3. 將服務帳戶新增至 Merchant Center:複製不重複的服務帳戶電子郵件地址 (例如 sa@project.iam.gserviceaccount.com),並在 Merchant Center 中新增為新使用者。詳情請參閱「如何從 Merchant Center 新增或移除使用者」
  4. 指派 Admin 存取權。如要進一步瞭解存取層級,請參閱「管理 Merchant Center 的使用者與存取層級」
  5. 使用程式碼範例設定驗證:請按照官方程式碼範例「設定驗證和範例設定」說明文件一節中的指引操作

如要進一步瞭解服務帳戶授權,請參閱「授權存取 Merchant Center 帳戶」和「服務帳戶總覽」。