このチュートリアルは、Cloud Talent Solution を使用するアプリケーションの探索と開発を開始できるように作られています。基本的なプログラミングの知識があることが前提ですが、プログラミングの深い知識がなくてもチュートリアルに沿って学習できます。このチュートリアルを修了すると、リファレンス ドキュメントを使用して独自の基本的なアプリケーションを作成できます。 チュートリアル動画やインタラクティブなコードラボも利用可能です。ご不明な点がございましたら、こちらからお問い合わせください。
前提条件
以下が必要です。
- 始める前にに説明されているとおり、プロジェクトの作成と設定の手順を行っていること。
- アプリケーションのデフォルト認証情報を使用して環境を設定していること。
- Java または Python プログラミングの基本事項を理解していること。
- 最新の Google API Java クライアントか Google API Python クライアントをインストールしていること。
会社と求人を作成し、その求人を検索する
このチュートリアルでは、基本的な Cloud Talent Solution アプリケーションについて順を追って説明し、Company リソースに関連付く 1 つの Job リソースを作成する手順を紹介します。次のチュートリアルでは、求人と検索クエリの属性に基づいてCompany 内の Job を検索する手順を説明します。search
API では、Job 内に用意されている項目(会社名、役職、求人の説明、求人のカテゴリ、勤務地など)に基づいて求職者のクエリに最も関連性の高い求人が返されます。
会社の作成
Company とは、求人情報に関連付けられているエンティティのことです。その会社の求人を Cloud Talent Solution に投稿する前に、Company オブジェクトを作成する必要があります。Company を作成するときは、自由形式の文字列を externalId
として送信できます。つまり、Company を作成し、参照する場合は、既存のデータベース(ある場合)の主キーを使用できます。
Go
CTS 用のクライアント ライブラリをインストールして使用する方法については、CTS クライアント ライブラリをご覧ください。 詳細については、CTS Go API のリファレンス ドキュメントをご覧ください。
CTS への認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証の設定をご覧ください。
Java
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Python
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
ジョブの作成
新しい Job リソースを投稿するには、求人に関するすべての必須フィールドと、この Job を関連付ける Company の companyName
を指定する必要があります。companyName
は、以前に Company リソースを作成したときに指定しています。
求人データが入力されたデータ オブジェクトは、POST リクエストを使用して Cloud Talent Solution エンドポイントに送信されます。name
フィールドは最初のリクエストでは設定しないでください。これは createJob
API の「出力のみ」項目であり、サーバーによって新しい求人エンティティが作成されるときに API レスポンスに含まれるためです。Job リソースとやり取りする API エンドポイントは、Cloud Talent Solution クライアント ライブラリ ドキュメントに示されています。
リクエストに対するレスポンスは、新しい Job オブジェクトです。そこに、この投稿を一意に表す Job の name
を含める必要があります。Job の name
は、投稿の更新や削除が必要になったときに使用します。この name
を保存して、お客様所有の一意の ID にマッピングすることをおすすめします。
新しく求人を作成しようとしたとき、同じ会社に対して同じ companyName
、requisitionId
、languageCode
を持つ別の求人がシステムにすでに存在していると、サーバーからエラーが返されます。
Cloud Talent Solution では、特定の場所に特化した求人も作成できます。詳細については、locations
をご覧ください。
次のコードでは、companyName
フィールドに指定された会社について必須フィールドのみを含む求人を作成します。
次のコードサンプルを使用して求人を作成できます。詳細については、クイックスタート: 会社と求人を作成するをご覧ください。
Go
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Java
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Python
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
カスタム フィールドを使用して求人を作成する
Cloud Talent Solution には、求人フィールドがいくつか API スキーマに組み込まれています。ただし、すぐに使えるオプションにはない追加のフィールドが必要になる場合があります。可能な限りすぐに使用できるフィールドを使用することをお勧めしますが、Cloud Talent Solution では求人用にいくつかの customAttributes
フィールドも用意しています。この中にはフィルタ可能なものと、そうでないものがあります。詳細については、customAttributes
ドキュメントをご覧ください。
次のコード例は、customAttribute
を使用して求人を作成する方法を示しています。
Go
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Java
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Python
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
求人の取得
GET オペレーションを使用して求人の詳細を取得することにより、求人が作成されたことを確認できます。Cloud Talent Solution に作成されている求人の現在の量により、求人が使用可能になるまでに数分かかる場合があります。
以前に挿入された求人の詳細を取得するには、GET リクエストを Cloud Talent Solution API に送信します。URI の中に、挿入済みの求人の name
を URL パラメータとして指定します。これは元の CREATE リクエストによって返された値です。
次の例では、GET 操作を使用して、指定された name
の求人の詳細を取得します。
Go
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Java
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Python
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
求人を検索する
Cloud Talent Solution を使用して最初の Company と Job を作成しました。これで、この Job すべてにわたって検索を実行する準備ができました。
その他の API
利用可能な API とさまざまな構成の詳細については、最新のリファレンス ドキュメントをご覧ください。