事前準備

總覽

您必須先在 Google Cloud Platform (GCP) 主控台中啟用 API，才能開始使用 Cloud Talent Solution (CTS)。請按照下列步驟操作：

  • 在 GCP 專案中啟用 CTS。
    1. 請確認已為 CTS 啟用計費功能。
    2. 接受《資料記錄條款及細則》。
    3. 建立及/或指派一或多個服務帳戶給 Cloud Talent Solution。
    4. 下載服務帳戶憑證金鑰。
  • 設定驗證環境變數。

GCP 主控台設定

  1. 前往 GCP 主控台。前往頁面頂端的下拉式選單，然後選擇要與 Cloud Talent Solution 建立關聯的 GCP 專案。如果您先前建立了一或多個專案，這些專案會顯示在彈出式選單的清單中。您可以選擇現有專案 (選取的專案旁會顯示勾號)，也可以按一下「NEW PROJECT」建立新專案。如要進一步瞭解如何建立 GCP 專案，請參閱說明文件。

  2. 如果您建立新專案，系統會提示您將帳單帳戶連結至該專案。如果您使用的是現有專案，請確認已啟用帳單服務。您隨時可以前往主要導覽選單 (左上角的漢堡圖示)，然後點選「帳單」選項，即可存取專案的帳單資訊：

  3. 選取 GCP 專案並連結至帳單帳戶後，您就可以啟用 Cloud Talent Solution API。前往主要導覽選單，然後向下捲動至「Artificial Intelligence」專區。按一下「Talent Solution」，然後在彈出的選單中選擇「總覽」：

  4. 如果您想先試用 API，而不將其連結至專案，可以選擇「TRY THIS API」選項。如要進一步瞭解如何使用這項功能，請參閱 Job Search API Explorer 說明文件。如要啟用 Cloud Talent Solution API，以便與 GCP 專案搭配使用，請按一下「啟用」：

  5. 資料記錄頁面隨即顯示。您必須接受條款及細則，才能享有 CTS 功能的完整存取權。如果您選擇不接受這些條款，就只能使用刪除 API 要求功能。按一下「啟用」：

  6. 系統現在會提示您將一或多個服務帳戶連結至 CTS API。如果您使用的專案已與服務帳戶建立關聯，這些帳戶會顯示在這個頁面的清單中。找到要連結至 CTS API 的帳戶，然後按一下旁邊的「連結」。完成後，您可以跳到步驟 8，確認已為該帳戶下載 JSON 或 P12 憑證。

    如果專案尚未有任何服務帳戶，系統會提示您建立一個。在「Service account name」 方塊中輸入所選名稱。系統會自動將您輸入的內容填入「服務帳戶 ID」方塊中。「Service account description」方塊是選填項目，但如果您打算將多個服務帳戶與專案建立關聯，建議您填寫。在這個方塊中輸入服務帳戶的簡短說明，然後按一下「建立」。

  7. 您可以在下一頁為新服務帳戶指派角色。請參閱 CTS IAM 權限頁面，進一步瞭解可用的角色和各角色允許的權限。按一下「Select a role」下拉式選單，然後向下捲動至「Cloud Talent Solution」。您可以從右側欄中的選項為這個服務帳戶選擇角色：

  8. 下一頁會提供幾項任務供你完成。這些不是必要步驟，但強烈建議您採取這些步驟。您可以輸入個別使用者的電子郵件地址，為他們授予您剛建立的服務帳戶存取權。您也可以為服務帳戶建立私密金鑰。使用 API 時，您必須在驗證程序期間使用私密金鑰。如果您選擇現在不採取這些動作，可以隨時透過主導覽選單中的 IAM 選項存取服務帳戶，產生金鑰並新增/變更個別使用者資訊。

    按一下「建立金鑰」：

    在彈出式選單中選擇所需格式，然後按一下「建立」：

    系統即會自動下載新的 JSON 或 P12 憑證檔案。將此檔案儲存在特定位置，並記下檔案路徑。您必須在驗證程序中將 GOOGLE_APPLICATION_CREDENTIALS 環境變數指向這個檔案。這是驗證傳送至 Cloud Talent Solution 的要求的重要步驟。

    憑證檔案下載完成後，請按一下「完成」：

  9. 您的服務帳戶現在會顯示在「Connect service accounts」(連結服務帳戶) 頁面上。按一下「連結」，將其連結至 CTS API：

  10. 帳戶已連結，您現在可以開始將 Cloud Talent Solution 整合到系統中：

設定驗證環境變數

Provide authentication credentials to your application code by setting the environment variable GOOGLE_APPLICATION_CREDENTIALS. This variable applies only to your current shell session. If you want the variable to apply to future shell sessions, set the variable in your shell startup file, for example in the ~/.bashrc or ~/.profile file.

Linux 或 macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

For PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

For command prompt:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Replace KEY_PATH with the path of the JSON file that contains your credentials.

如需詳細資訊，請參閱 GCP 驗證說明文件。

後續步驟

請安裝用戶端程式庫，或參閱建立職缺和公司快速入門課程，開始發出 API 呼叫。