您可以使用服務帳戶,授權 Merchant API 存取您自己的商家帳戶。如果您的應用程式需要存取客戶的商家帳戶,請參閱「授權第三方應用程式存取商家帳戶」一文。
服務帳戶是一種特殊帳戶,通常由應用程式 (而非使用者) 使用。服務帳戶是以帳戶的唯一電子郵件地址來識別。
您必須具備商家帳戶,才能建立服務帳戶。
建立服務帳戶
產生服務帳戶憑證或存取您已產生的公開憑證,然後建立 OAuth 2.0 用戶端 ID:
- 前往 Google API 控制台。
- 在頁面頂端的下拉式選單中選取專案,或是按一下「NEW PROJECT」建立專案。
- 在 Google API 清單中搜尋 Merchant API,並確認這項專案已啟用該 API。
- 點選「管理」。
- 在左側欄中,選取「憑證」。您可能需要按一下頁面左上方的向左箭頭,才能看到「憑證」。
- 依序選取「建立憑證」和「服務帳戶」。
- 命名服務帳戶。這是服務帳戶 ID 的預設使用者名稱。儲存服務帳戶 ID (包括「@」字元後的部分),以供日後使用。
按一下「建立」,然後完成必要步驟以授予專案和使用者的存取權,然後按一下「DONE」。
取得 JSON 私密金鑰
在 Google API 控制台中,為服務帳戶產生 JSON 私密金鑰:
- 按一下服務帳戶,然後選取「金鑰」分頁標籤。
- 依序按一下「新增金鑰」>「建立新的金鑰」。
- 選取「JSON」做為金鑰類型。
- 按一下「建立」,下載私密金鑰。注意:您只能在建立已建立的金鑰時下載。您之後無法再回頭進行這個步驟。
將商家帳戶存取權授予服務帳戶
將新服務帳戶新增為商家帳戶的使用者:
- 登入 Merchant Center。
- 按一下帳戶設定中的「帳戶存取權」。
按一下「+ 新增使用者」,並將服務帳戶 ID 做為新使用者的電子郵件地址。
如果您未儲存服務帳戶 ID,請前往服務帳戶管理頁面,然後選取您的專案。
指定服務帳戶的「使用者存取權」和「電子郵件通知」偏好設定。
按一下「Add user」(新增使用者),儲存偏好設定並返回使用者清單。服務帳戶 ID 現在應隨所選使用者角色列出。
您可以為每個需要存取商家帳戶資料的服務帳戶重複執行上述步驟。
常見問題
- 我可以使用服務帳戶登入 Merchant Center UI 嗎?
- 不可以,服務帳戶不是一般 Google 帳戶,而且無法存取 Merchant Center UI。
- 我需要多久更新服務帳戶存取權杖?
- Google OAuth 2.0 授權伺服器核發的存取權杖後,會在一小時後失效。存取權杖到期時,應用程式應透過用戶端程式庫擷取其他存取權杖。如要手動重新整理權杖,請刪除 saved-token.json 檔案並重新驗證。