事前準備
開始之前,請先準備下列項目:
經銷商網域的超級管理員存取權。如需更多資訊,請參閱如何存取 Cloud Channel API。
Google Cloud 控制台和 Partner Sales Console 的存取權。
步驟 1:準備 Partner Sales Console
您必須接受 Channel Services 平台的條款及細則,才能使用 API。
以經銷商網域的管理員身分,至少登入 Partner Sales Console 一次。首次登入時,您必須接受經銷商服務條款 (如適用)。如果您已離線接受特定服務條款,則不適用這個步驟。
你可以在 Partner Sales Console 的條款頁面中接受其他服務條款。
步驟 2:設定 Google Cloud 專案
如要使用任何 Google API,您必須擁有 Google Cloud 專案。
建立 Google Cloud 專案
如要建立專案,請前往 Google Cloud 主控台的「專案」區域,然後按一下「建立專案」 。
如需建立專案的詳細操作說明和最佳做法清單,請參閱建立及管理專案指南。
大多數的代銷商會在主要Google Cloud 機構下建立 Google Cloud 專案,而不是在代銷商網域下建立。如要授予服務帳戶存取經銷商網域資料的權限,請設定全網域委派,讓服務帳戶存取經銷商網域的資料。
為專案命名,名稱請使用描述性文字。專案 ID 是任意 ID,不會影響您呼叫 Cloud Channel API 的能力。
啟用 API
前往 Google Cloud 控制台的「API 程式庫」部分,啟用 Cloud Channel API。
建立服務帳戶
如要建立服務帳戶,請前往「服務帳戶」頁面。
- 按一下「Create Service Account」(建立服務帳戶) 。
- 輸入服務帳戶名稱 (以及選用的服務帳戶說明),然後按一下「建立」。
- 點選「Continue」即可略過「Grant service account access to project」選項。
- 略過「將這個服務帳戶的存取權授予使用者」部分,然後按一下「Done」,即可完成建立帳戶。
建立帳戶後,請建立服務帳戶金鑰:
- 在 Google Cloud 控制台中,按一下您建立的服務帳戶電子郵件地址。
- 點選「金鑰」。
- 依序點選「新增金鑰」和「建立新的金鑰」。
按一下「建立」,JSON 金鑰檔案會下載至您的電腦。
請務必妥善保存金鑰檔案,因為此檔案可當做服務帳戶進行驗證。您可以任意移動及重新命名這個檔案。
按一下 [關閉]。
您可以在「服務帳戶」頁面中刪除及建立私密金鑰檔案。
步驟 3:為經銷商網域授權服務帳戶
您需要服務帳戶的用戶端 ID 才能使用這個部分。在
「動作」選單中,選取「管理詳細資料」,然後複製「專屬 ID」。使用經銷商網域的超級管理員帳戶前往網域層級委派頁面。
- 按一下「新增」,然後在「用戶端 ID」欄位中輸入服務帳戶的 ID。
- 在「OAuth 範圍」欄位中輸入
https://www.googleapis.com/auth/apps.order
。 - 按一下「授權」,允許服務帳戶在 Channel Services 帳戶的環境中使用 Cloud Channel API。
接著按一下「授權」,讓服務帳戶可在 Channel Services 帳戶的環境中使用 Cloud Channel API。
後續步驟
完成初步技術整合後,您可以閱讀 Cloud Channel API 說明文件,瞭解 API。