始める前に（v4beta1）

概要

Cloud Talent Solution（CTS）の使用を開始する前に、Google Cloud Platform（GCP）Console で API を有効にする必要があります。次の手順は、以下の操作について説明しています。

  • GCP プロジェクトで CTS を有効にします。
    1. CTS の課金が有効になっていることを確認します。
    2. データロギングの利用規約に同意します。
    3. サービス アカウントを 1 つ以上 Cloud Talent Solution に割り当てます（アカウントがない場合は作成します）。
    4. サービス アカウントの認証情報キーをダウンロードする。
  • 認証情報の環境変数を設定する

GCP コンソールの設定

  1. GCP Console に移動します。 ページ上部のプルダウン メニューで、Cloud Talent Solution に関連付ける GCP プロジェクトを選択します。前にプロジェクトを作成している場合、それがポップアップ メニューのリストに表示されます。既存のプロジェクトを選択するか（選択したプロジェクトの横にチェックマークが表示されます）、[新しいプロジェクト] をクリックして新しいプロジェクトを作成できます。GCP プロジェクトの作成の詳細については、こちらのドキュメントをご覧ください。

  2. 新しいプロジェクトを作成する場合、請求先アカウントをこのプロジェクトに接続するように求められます。既存のプロジェクトを使用している場合は、課金が有効になっていることを確認します。メインのナビゲーション メニュー（左上隅の三本線アイコン）で [お支払い] オプションをクリックすると、いつでもプロジェクトのお支払い情報にアクセスできます。

  3. GCP プロジェクトを選択して請求先アカウントに接続すると、Cloud Talent Solution API を有効にできます。メインのナビゲーション メニューを、[人工知能] セクションまでスクロールします。[Talent Solution] をクリックして、ポップアップ メニューで [概要] を選択します。

  4. 最初に API をプロジェクトに接続せずに試してみたい場合は、[この API を試す] オプションを選択できます。この機能の使用方法の詳細については、Job Search API Explorerのドキュメントをご覧ください。Cloud Talent Solution API を GCP プロジェクトで使用できるようにするには、[有効にする] をクリックします。

  5. データ ロギング ページが表示されます。CTS 機能のすべてにアクセスするには、利用規約に同意する必要があります。この規約に同意しないことを選択した場合は、削除の API リクエストのみを使用できます。[有効にする] をクリックします。

  6. 1 つ以上のサービス アカウントを CTS API に接続するように求められます。すでにサービス アカウントが関連付けられているプロジェクトを使用している場合は、このページにそれが一覧表示されます。CTS API に接続するアカウントの横にある [接続] をクリックします。接続が終わると、ステップ 8 までスキップして、そのアカウントの JSON または P12 認証情報をダウンロードしたことを確認できます。

    プロジェクトにまだサービス アカウントがない場合は、作成するように求められます。任意の名前を [サービス アカウント名] ボックスに入力します。その入力内容に従って [サービス アカウント ID] ボックスは自動的に入力されます。[サービス アカウントの説明] ボックスは省略できますが、複数のサービスアカウントをプロジェクトに関連付ける予定がある場合は入力することをおすすめします。このボックスにサービス アカウントの簡単な説明を入力し、[作成] をクリックします。

  7. 次のページでは、新しいサービス アカウントにロールを割り当てます。使用可能なロールとそれぞれに許可されている権限の詳細については、CTS IAM 権限のページをご覧ください。プルダウン メニューの [ロールを選択] をクリックし、[Cloud Talent Solution] までスクロールします。このサービスアカウントのロールは、右側の列の選択肢から選びます。

  8. 次のページでは、複数のタスクを実行する選択肢が与えられます。これは必須ではありませんが、強くおすすめします。作成したサービス アカウントへのアクセス権を、各ユーザーに付与するには、そのユーザーのメールアドレスを入力します。サービス アカウントの秘密鍵を作成することもできます。API を使用する場合は、認証プロセスで秘密鍵を使用する必要があります。これらの操作を今すぐ行わない場合、メイン ナビゲーション メニューの IAM オプションからサービス アカウントにアクセスして、いつでも鍵を生成し、個々のユーザー情報を追加 / 変更できます。

    [キーを作成] をクリックします。

    ポップアップ メニューで希望の形式を選択し、[作成] をクリックします。

    新しい JSON または P12 認証情報ファイルは自動的にダウンロードされます。このファイルを特定の場所に保存し、ファイルパスをメモします。認証プロセスを実行するときに、このファイルをGOOGLE_APPLICATION_CREDENTIALS環境変数に指定する必要があります。 これは Cloud Talent Solution に対するリクエストの認証に欠かせない手順です。

    認証情報ファイルがダウンロードされたら、[完了] をクリックします。

  9. サービス アカウントが [サービス アカウントの接続] ページに表示されます。[接続] をクリックして、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 呼び出しを使い始めるため、クライアント ライブラリをインストールするか、求人と会社の作成クイックスタートをご覧ください。