服務帳戶是特殊的 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 相關聯的角色。如果不確定要選取什麼,請依序選取「專案」>「檢視者」。
- 系統會將您導向「服務帳戶」頁面,您可以在該頁面存取新的服務帳戶。
- 如要取得 JSON 私密金鑰,請按一下服務帳戶,然後點選「金鑰」分頁標籤。依序點選「新增金鑰」>「建立新的金鑰」,然後選取 JSON 做為金鑰類型。按一下「建立」,將私密金鑰下載到電腦。
- 將新的服務帳戶新增為 Merchant Center 帳戶的使用者。如果您是第三方開發人員,請由客戶為您完成這個步驟。
- 前往 Merchant Center 帳戶。
- 前往 Merchant Center 帳戶設定中的「帳戶存取權」。
- 按一下「+ 新增使用者」,然後使用服務帳戶 ID 做為新使用者的電子郵件地址。
- 指定服務帳戶的「使用者存取權」和「電子郵件通知」偏好設定。請注意,使用
Accounts服務需要管理員存取權。 - 按一下「新增使用者」,儲存偏好設定並返回使用者清單。服務帳戶 ID 應會列出所選使用者角色。
- 針對要新增的所有其他服務帳戶重複上述程序。
- 現在,你可以使用Google 應用程式預設憑證流程,或直接使用服務帳戶流程,透過服務帳戶存取 Merchant Center 帳戶。Content API for Shopping 範例會說明如何在每個支援的程式設計語言中,使用這兩種服務帳戶憑證流程。請查看程式碼範例,試用新的服務帳戶,並瞭解在自己的程式碼中使用服務帳戶時需要進行哪些變更。
常見問題
- 我可以使用服務帳戶登入 Merchant Center 使用者介面嗎?
- 否,服務帳戶不是一般的 Google 帳戶,無法存取 Merchant Center 使用者介面。
- 服務帳戶存取權杖需要多久更新一次?
- Google OAuth 2.0 授權伺服器核發存取權杖後,權杖會在 1 小時後失效。存取權杖到期時,應用程式應使用用戶端程式庫擷取另一個存取權杖。