服務帳戶

服務帳戶是一種特殊的 Google 帳戶,可讓應用程式透過 OAuth 2.0 以程式輔助方式存取 Google API。服務帳戶使用的 OAuth 2.0 流程不需要人為授權。而是使用僅限應用程式可存取的金鑰檔案。本指南將說明如何透過服務帳戶存取 Content API for Shopping。

注意:使用服務帳戶進行驗證的應用程式只能存取您自己的 Merchant Center 帳戶。如果您要編寫第三方應用程式,需要存取您客戶的 Merchant Center 帳戶,請改為參閱授權要求指南。

必要條件

使用服務帳戶存取 Content API for Shopping 的步驟

  1. 產生服務帳戶憑證或存取您已產生的公開憑證。您必須建立 OAuth 2.0 用戶端 ID 並取得 *.json 私密金鑰檔案:
    1. 前往 Google API 控制台
    2. 在頁面頂端的下拉式選單中選取專案。如果您還沒有專案,請按一下 [新增專案] 建立一個。
    3. 如果您尚未為這項專案啟用 Content API for Shopping,請在 Google API 清單中搜尋並啟用 API。
    4. 在左側欄中,選取 [憑證]。 您可能需要按一下左上角的向左箭頭,才能看到此圖示。
    5. 如果要設定服務帳戶,請依序選取「CREATE CREDENTIALS」和「Service account」
    6. 為新的服務帳戶命名。也可以做為服務帳戶 ID 的預設使用者名稱。記下服務帳戶 ID,包括「@」字元之後的部分,以供日後使用。按一下 [建立],然後完成授予專案和使用者存取權的選用步驟,然後按一下 [完成]。

      對服務帳戶的角色選擇不會對內容 API 呼叫造成任何影響,因為 Content API 方法的存取權取決於其與 Merchant Center 服務帳戶 ID 相關聯的角色。如果不確定該選擇哪些項目,只要依序選擇 [Project] (專案) > [Viewer] (檢視者) 即可。

    7. 系統會將您導向服務帳戶頁面,方便您存取新服務帳戶。
    8. 如要取得 JSON 私密金鑰,請按一下服務帳戶,然後按一下 [KEYS] 分頁標籤。依序點選 [新增金鑰] > [建立新的金鑰],然後選取 JSON 做為金鑰類型。按一下 [CREATE] (建立),將私密金鑰下載到您的電腦。
  2. 將新服務帳戶新增為 Merchant Center 帳戶的使用者。如果您是第三方開發人員,您必須請客戶為您執行這個步驟。
    1. 前往 Merchant Center 帳戶
    2. 前往 Merchant Center 帳戶中設定中的「帳戶存取權」
    3. 按一下 [+ Add user],然後將服務帳戶 ID 做為新使用者的電子郵件地址。

      如果您之前沒有記下服務帳戶 ID,請前往「Service Accounts」(服務帳戶) 管理頁面,並選取您建立的專案。

    4. 指定服務帳戶的「User access」(使用者存取權) 和「Email Notifications」(電子郵件通知) 偏好設定。請注意,使用 Accounts 服務需要 Admin 存取權。
    5. 按一下 [Add user] (新增使用者) 以儲存偏好設定,然後返回使用者清單。服務帳戶 ID 應與所選使用者角色一同列出。
    6. 對所有其他要新增的服務帳戶重複執行這個程序。
  3. 您現在可以使用 Google 應用程式預設憑證流程,或直接使用服務帳戶流程,透過服務帳戶存取 Merchant Center 帳戶。Content API for Shopping 的範例說明瞭如何使用這兩種支援程式語言中的服務帳戶憑證。請查看程式碼範例來試用新的服務帳戶,並瞭解在自己的程式碼中使用服務帳戶需要進行哪些變更。

常見問題

我可以使用服務帳戶登入 Merchant Center 使用者介面嗎?
不可以,服務帳戶不是一般的 Google 帳戶,並且無法存取 Merchant Center UI。
我多久需要重新整理服務帳戶存取憑證?
存取憑證經 Google OAuth 2.0 授權伺服器核發後一小時就會失效。存取權杖到期時,應用程式應使用用戶端程式庫擷取另一個存取權杖。