將 OAuth 2.0 服務帳戶搭配 Manufacturer Center API 使用

服務帳戶是一種特殊的 Google 帳戶,可供應用程式使用,透過 OAuth 2.0 以程式輔助方式存取 Google API。服務帳戶使用不需要其他授權的 OAuth 2.0 流程。而是使用只有您的應用程式可以存取的金鑰檔案。本指南將說明如何透過服務帳戶存取 Manufacturer Center API。

先備知識

使用服務帳戶存取 Manufacturer Center API 的步驟

  1. 產生服務帳戶憑證,或存取您已產生的公開憑證。您需要建立 OAuth 2.0 用戶端 ID,並取得 *.json 私密金鑰檔案:

    1. 前往 Google API 控制台

    2. 在頁面頂端的下拉式選單中選取專案。如果您尚未建立專案,請按一下「Create Project」(建立專案) 來建立專案。

    3. 如果您尚未為這項專案啟用 Manufacturer Center API,請在 Google API 清單中搜尋並啟用該 API。

    4. 在左側欄中,選取「憑證」

    5. 如要設定服務帳戶,請依序選取「Create credentials」(建立憑證) 和「Service account key」(服務帳戶金鑰)

    建立服務帳戶憑證的螢幕截圖。

    1. 在下一頁的下拉式清單中選取「New service account」

    2. 為新的服務帳戶命名。這也可做為服務帳戶 ID 的預設使用者名稱。請記住服務帳戶 ID,供稍後使用。

    新服務帳戶名稱螢幕截圖。

    1. 選取「JSON」做為金鑰類型,然後按一下「建立」

    2. 「Create」按鈕會變更為「Create...」,且金鑰產生完畢後,將自動將私密金鑰下載為 *.json 檔案。

    1. 您將會返回「憑證」頁面,您應該會在帳戶的服務帳戶金鑰清單中看到新的服務帳戶。
  2. 將新服務帳戶新增為 Manufacturer Center 帳戶的使用者。如果您是第三方開發人員,則必須請客戶為您執行這個步驟。

    1. 前往 Manufacturer Center 帳戶

    2. 前往 Manufacturer Center 帳戶設定的「使用者」清單。

    3. 按一下「+User」按鈕,並使用服務帳戶 ID 做為新使用者的電子郵件地址。

      「新增服務帳戶使用者」按鈕的螢幕截圖。

    4. 填寫表單並提供服務帳戶 ID,然後選取所需的使用者角色。至少須選擇一項,如要使用 Accounts 服務,則必須具備管理員角色。

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

    新增服務帳戶使用者頁面螢幕截圖。

    1. 按一下「Save」按鈕。您會回到使用者名單,而服務帳戶 ID 應與所選使用者角色一併列出。

    2. 對其他所有要新增的服務帳戶重複執行以上程序。

    3. 前往「使用者」分頁,即可查看現有服務帳戶使用者。這些使用者即為電子郵件地址結尾為「gserviceaccount.com」的使用者。

  3. 您現在可以透過 Google 應用程式預設憑證流程,或直接使用服務帳戶流程,透過服務帳戶存取 Manufacturer Center 帳戶。Manufacturer Center API 範例說明如何以每種支援的程式設計語言,將這兩種流程用於服務帳戶憑證。請參閱程式碼範例,瞭解如何試用新的服務帳戶,並瞭解必須在自己的程式碼中使用服務帳戶進行哪些變更。

常見問題

我可以使用服務帳戶登入 Manufacturer Center 網頁使用者介面嗎?

否,服務帳戶不是一般 Google 帳戶,無法存取 Manufacturer Center 網頁使用者介面。

需要多久更新一次服務帳戶存取權杖?

存取權杖由 Google OAuth 2.0 授權伺服器發出後一小時就會失效。存取權杖到期時,應用程式應使用用戶端程式庫擷取其他存取權杖。