服務帳戶

服務帳戶是一種特殊的 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. 在頁面頂端的下拉式選單中選取專案。如果您還沒有專案，請按一下「NEW PROJECT」建立專案。
    3. 如果您尚未為這個專案啟用 Content API for Shopping，請在 Google API 清單中搜尋並啟用該 API。
    4. 在左側欄中，選取「憑證」。您可能需要按一下左上方的左向箭頭，才能查看這項資訊。
    5. 如要設定服務帳戶，請依序選取「建立憑證」和「服務帳戶」。
    6. 為新服務帳戶命名。這也是服務帳戶 ID 的預設使用者名稱。記下服務帳戶 ID (包括「@」字元後的部分)，以便日後使用。按一下「建立」，然後依序完成授予專案和使用者存取權的選用步驟，然後按一下「完成」。

      服務帳戶的角色選擇不會影響可向 Content API 發出的呼叫，因為 Content API 方法的存取權是由 Merchant Center 中與服務帳戶 ID 相關聯的角色決定。如果不確定要選取哪個選項，請依序選取「Project」>「Viewer」。

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

      如果您之前未記下服務帳戶 ID，請前往服務帳戶管理頁面，然後選取您建立的專案。

    4. 指定服務帳戶的使用者存取權和電子郵件通知偏好設定。請注意，您必須具備管理員存取權，才能使用 Accounts 服務。
    5. 按一下「新增使用者」即可儲存偏好設定，並返回使用者清單。服務帳戶 ID 應列出所選使用者角色。
    6. 針對要新增的所有其他服務帳戶重複執行上述步驟。
  3. 你現在可以使用服務帳戶存取 Merchant Center 帳戶，方法是使用 Google 應用程式預設憑證流程，或是直接使用服務帳戶流程。在 Content API for Shopping 範例中，我們會說明如何在每種支援的程式設計語言中，使用服務帳戶憑證的兩種流程。請查看程式碼範例，試用新的服務帳戶，並瞭解在自己的程式碼中使用服務帳戶時，需要進行哪些變更。

常見問題

我可以使用服務帳戶登入 Merchant Center UI 嗎？
不，服務帳戶不是一般 Google 帳戶，無法存取 Merchant Center UI。
我需要多久更新一次服務帳戶存取權杖？
存取權杖會在 Google OAuth 2.0 授權伺服器核發後一小時失效。存取權杖到期時，應用程式應使用用戶端程式庫擷取其他存取權杖。