服務帳戶是一種特殊的 Google 帳戶,可供應用程式使用,透過 OAuth 2.0 以程式輔助方式存取 Google API。服務帳戶使用不需要其他授權的 OAuth 2.0 流程。而是使用只有您的應用程式可以存取的金鑰檔案。本指南將說明如何透過服務帳戶存取 Manufacturer Center API。
先備知識
使用服務帳戶存取 Manufacturer Center API 的步驟
產生服務帳戶憑證,或存取您已產生的公開憑證。您需要建立 OAuth 2.0 用戶端 ID,並取得 *.json 私密金鑰檔案:
前往 Google API 控制台。
在頁面頂端的下拉式選單中選取專案。如果您尚未建立專案,請按一下「Create Project」(建立專案) 來建立專案。
如果您尚未為這項專案啟用 Manufacturer Center API,請在 Google API 清單中搜尋並啟用該 API。
在左側欄中,選取「憑證」。
如要設定服務帳戶,請依序選取「Create credentials」(建立憑證) 和「Service account key」(服務帳戶金鑰)。
選取「JSON」做為金鑰類型,然後按一下「建立」。
「Create」按鈕會變更為「Create...」,且金鑰產生完畢後,將自動將私密金鑰下載為 *.json 檔案。
- 您將會返回「憑證」頁面,您應該會在帳戶的服務帳戶金鑰清單中看到新的服務帳戶。
將新服務帳戶新增為 Manufacturer Center 帳戶的使用者。如果您是第三方開發人員,則必須請客戶為您執行這個步驟。
前往 Manufacturer Center 帳戶設定的「使用者」清單。
按一下「+User」按鈕,並使用服務帳戶 ID 做為新使用者的電子郵件地址。
填寫表單並提供服務帳戶 ID,然後選取所需的使用者角色。至少須選擇一項,如要使用
Accounts
服務,則必須具備管理員角色。
如果您之前未記下服務帳戶 ID,請前往服務帳戶管理頁面,然後選取您建立的專案。
按一下「Save」按鈕。您會回到使用者名單,而服務帳戶 ID 應與所選使用者角色一併列出。
對其他所有要新增的服務帳戶重複執行以上程序。
前往「使用者」分頁,即可查看現有服務帳戶使用者。這些使用者即為電子郵件地址結尾為「gserviceaccount.com」的使用者。
您現在可以透過 Google 應用程式預設憑證流程,或直接使用服務帳戶流程,透過服務帳戶存取 Manufacturer Center 帳戶。Manufacturer Center API 範例說明如何以每種支援的程式設計語言,將這兩種流程用於服務帳戶憑證。請參閱程式碼範例,瞭解如何試用新的服務帳戶,並瞭解必須在自己的程式碼中使用服務帳戶進行哪些變更。
常見問題
我可以使用服務帳戶登入 Manufacturer Center 網頁使用者介面嗎?
否,服務帳戶不是一般 Google 帳戶,無法存取 Manufacturer Center 網頁使用者介面。
需要多久更新一次服務帳戶存取權杖?
存取權杖由 Google OAuth 2.0 授權伺服器發出後一小時就會失效。存取權杖到期時,應用程式應使用用戶端程式庫擷取其他存取權杖。