技術設定

事前準備

開始之前,請先準備下列項目:

  • 經銷商網域的超級管理員存取權。如需更多資訊,請參閱如何存取 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

建立服務帳戶

如要建立服務帳戶,請前往「服務帳戶」頁面。

前往「Service accounts」(服務帳戶)

  1. 按一下「Create Service Account」(建立服務帳戶)
  2. 輸入服務帳戶名稱 (以及選用的服務帳戶說明),然後按一下「建立」
  3. 點選「Continue」即可略過「Grant service account access to project」選項。
  4. 略過「將這個服務帳戶的存取權授予使用者」部分,然後按一下「Done」,即可完成建立帳戶。

建立帳戶後,請建立服務帳戶金鑰:

  1. 在 Google Cloud 控制台中,按一下您建立的服務帳戶電子郵件地址。
  2. 點選「金鑰」
  3. 依序點選「新增金鑰」和「建立新的金鑰」
  4. 按一下「建立」,JSON 金鑰檔案會下載至您的電腦。

    請務必妥善保存金鑰檔案,因為此檔案可當做服務帳戶進行驗證。您可以任意移動及重新命名這個檔案。

  5. 按一下 [關閉]

您可以在「服務帳戶」頁面中刪除及建立私密金鑰檔案。

步驟 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。