服務帳戶是一種特殊的 Google 帳戶,可讓應用程式透過 OAuth 2.0 以程式輔助方式存取 Google API。服務帳戶使用不需要人工授權的 OAuth 2.0 流程。而是使用只有您的應用程式可以存取的金鑰檔案。本指南將說明如何使用服務帳戶存取 Content API for Shopping。
注意:使用服務帳戶進行驗證的應用程式只能存取您自己的 Merchant Center 帳戶。如果您要編寫需要存取客戶 Merchant Center 帳戶的第三方應用程式,請改為參閱「授權要求」指南。
必要條件
- Merchant Center 帳戶。
使用服務帳戶存取 Content API for Shopping 的步驟
- 產生服務帳戶憑證,或存取您已產生的公開憑證。您必須建立 OAuth 2.0 用戶端 ID,並取得 *.json 私密金鑰檔案:
- 前往 Google API 控制台。
- 在頁面頂端的下拉式選單中選取專案。如果您還沒有專案,請按一下「NEW PROJECT」建立專案。
- 如果您尚未為這個專案啟用 Content API for Shopping,請在 Google API 清單中搜尋並啟用該 API。
- 在左側欄中,選取「憑證」。您可能需要按一下左上方的左向箭頭,才能查看這項資訊。
- 如要設定服務帳戶,請依序選取「建立憑證」和「服務帳戶」。
- 為新服務帳戶命名。這也是服務帳戶 ID 的預設使用者名稱。記下服務帳戶 ID (包括「@」字元後的部分),以便日後使用。按一下「建立」,然後依序完成授予專案和使用者存取權的選用步驟,然後按一下「完成」。
服務帳戶的角色選擇不會影響可向 Content API 發出的呼叫,因為 Content API 方法的存取權是由 Merchant Center 中與服務帳戶 ID 相關聯的角色決定。如果不確定要選取哪個選項,請依序選取「Project」>「Viewer」。
- 系統會將您導向「Service Accounts」(服務帳戶) 頁面,您可以在該頁面存取新的服務帳戶。
- 如要取得 JSON 私密金鑰,請依序點選服務帳戶和「KEYS」分頁標籤。按一下「新增金鑰」>「建立新金鑰」,然後選取 JSON 做為金鑰類型。按一下「CREATE」,將私密金鑰下載到電腦。
- 將新服務帳戶新增為 Merchant Center 帳戶的使用者。如果您是第三方開發人員,則需要請客戶為您執行這個步驟。
- 前往 Merchant Center 帳戶。
- 前往 Merchant Center 帳戶設定頁面的「帳戶存取權」。
- 按一下「+ 新增使用者」,然後使用服務帳戶 ID 做為新使用者的電子郵件地址。
如果您之前未記下服務帳戶 ID,請前往服務帳戶管理頁面,然後選取您建立的專案。
- 指定服務帳戶的使用者存取權和電子郵件通知偏好設定。請注意,您必須具備管理員存取權,才能使用
Accounts
服務。 - 按一下「新增使用者」即可儲存偏好設定,並返回使用者清單。服務帳戶 ID 應列出所選使用者角色。
- 針對要新增的所有其他服務帳戶重複執行上述步驟。
- 你現在可以使用服務帳戶存取 Merchant Center 帳戶,方法是使用 Google 應用程式預設憑證流程,或是直接使用服務帳戶流程。在 Content API for Shopping 範例中,我們會說明如何在每種支援的程式設計語言中,使用服務帳戶憑證的兩種流程。請查看程式碼範例,試用新的服務帳戶,並瞭解在自己的程式碼中使用服務帳戶時,需要進行哪些變更。
常見問題
- 我可以使用服務帳戶登入 Merchant Center UI 嗎?
- 不,服務帳戶不是一般 Google 帳戶,無法存取 Merchant Center UI。
- 我需要多久更新一次服務帳戶存取權杖?
- 存取權杖會在 Google OAuth 2.0 授權伺服器核發後一小時失效。存取權杖到期時,應用程式應使用用戶端程式庫擷取其他存取權杖。