Cloud Talent Solution では、Cloud Talent Solution のインデックスに格納されている求人を検索できます。このドキュメントでは、Cloud Talent Solution のさまざまな検索と関連サービスについて説明します。
検索リクエスト
求人検索リクエストを行うには、POST リクエストを jobs:search エンドポイントに送信し、本文で検索データを渡します。
必須項目
次の項目は必須です。
searchMode: 適用する求人検索のタイプを指定します。次の選択肢があります。JOB_SEARCH: これは、デフォルトの推奨される検索モードです。 すべての求人が検索されます。最も関連性の高い求人が、検索クエリとの関連性の順に返されます。FEATURED_JOB_SEARCH:promotionValueが 0 より大きい求人のみを検索します。結果は、まずpromotionValueの高い順に並べられます。同順位の場合は、関連性を使用して位置が決定されます。詳しくは、注目の求人をご覧ください。
よく使用されるフィールド
JobQuery: 照合する求人条件を指定します。この条件には、場所、職種、雇用タイプ、テキストクエリ、会社などがあります。詳しくは、検索フィルタをご覧ください。requestMetadata: この検索リクエストのユーザー情報とセッション情報を含みます。詳細については、RequestMetadata をご覧ください。jobView: 一致した Job オブジェクトのそれぞれに対して返されるフィールドの数を定義します。JOB_VIEW_SMALL（デフォルト）、JOB_VIEW_MINIMAL、JOB_VIEW_FULLを指定できます。各オプションの説明は、JobViewリファレンスをご覧ください。orderBy: 返される求人の並べ替え順序。使用できる値については、リファレンスをご覧ください。デフォルトでは、関連性の降順に並べ替えられます（RELEVANCE_DESC）。
関連性のしきい値設定と場所 / 職種の拡大
より多くの求人検索結果を返すために、次の 2 つの項目で関連性の制限が緩和されます。
enableBroadening: これをtrueに設定すると、より多くの結果を返すために、検索リクエストの場所および職種の制限が緩和されます。たとえば、検索リクエストで Anytown, WA の半径 2 マイル以内の求人が指定された場合、このフラグをtrueに設定すると、NextTownOver, WA の求人も返される可能性があります。disableKeywordMatch: デフォルトでは、このフラグは false です。このフラグを false に設定すると、Cloud Talent Solution ではこの検索クエリに関連する求人を役職や職務内容の正確なクエリ文字列にも一致する求人に追加できます。
RequestMetadata
すべての検索とヒストグラム リクエストには、RequestMetadata オブジェクトを含める必要があります。このオブジェクトには、検索を開始したユーザーに関する情報が含まれます。
このオブジェクトが重要な理由はいくつかあります。
ユーザーの整合性。Cloud Talent Solution では、検索の関連性を改善するために、複数のバージョンの基盤モデルを同時に実行します。求職者が一貫した体験を得られるように、このフィールドを入力してください。Cloud Talent Solution では、userId、sessionId、domain によって求職者を識別し、求職者が一貫したエクスペリエンスを得られるようにします。注: これらの項目は難読化する必要があります。
検索の改善。調整アルゴリズムは、
RequestMetadataフィールドで提供される情報と、提供する求職者のデータに基づいています。これにより、検索結果の関連性が向上します。
検索演算子
| 演算子 | 説明 |
|---|---|
| ( ) | 1 つ以上のキーワードをグループ化します。 |
| AND | 演算子の両側のキーワードまたはキーワードのグループに関連する結果を検索します。 |
| OR | 演算子のいずれか片側のキーワードまたはキーワードのグループに関連する結果を検索します。 |
| NOT | 演算子の直後のかっこ内のキーワードまたはキーワードのグループに関連する結果を除外します。 |
| - | 演算子の後に付加されたキーワードまたはキーワードのグループに関連する結果を除外します。 |
例:
"software OR java"は、メタデータに「software」または「java」のいずれかが含まれるジョブを返します。"software" -javaは「software」に関連する求人を返しますが、「java」に関連する求人は除外します。"(software OR java) AND (marketing)"は、「software」と「marketing」の両方に関連する求人と、「java」と「marketing」の両方に関連する求人を返します。
求職者のクエリ
検索キーワードは、実際の求人に関連するエンティティとして検出することもできます。たとえば、「intern」のクエリの場合、Cloud Talent Solution はこれを雇用タイプの「INTERN」として扱い、EMPLOYMENT_TYPE - INTERN のみを持つ求人をフィルタリングします。したがって、たとえ求人の説明に intern と記載されていても、求人の雇用タイプが他の値に設定されていた場合、その求人は返されません。
トラブルシューティング
各検索リクエストは、検索のパラメータとレスポンスを追跡するために使用される一意の検索 requestID をシステム内に生成します。この ID は、特定の検索や CRUD リクエストに関連する問題のトラブルシューティング時に不可欠であり、適切にログに記録される必要があります。requestId は、検索レスポンスの本文または関連付けられた CRUD 呼び出しレスポンス オブジェクトの ResponseMetadata フィールドに返されます。
関連性、検索についての問い合わせ、インデックス作成についての問い合わせなどに関するサポートの問題については、サポートチームにチケットを提出し、関連するリクエスト ID を記載するか、または ID 自体をリクエストしてください。
結果の件数
結果の件数は、求職者に検索結果の数を伝えるために使用されます。これは、必ずしもヒストグラムの結果や返される求人の実際の件数に一致するとは限りません。求人検索は最大 5000 件の求人を返します。
ページ分割
デフォルトでは、求人検索は 1 ページあたり 100 件の結果を返します（結果の総数が 100 未満の場合はそれ以下）。ページ分けは、この機能に関連付けられたフィールドを使用して実装できます。
pageSize: ページごとに返される結果の数。nextPageToken: 検索結果の各ページの結果とともに返される一意のトークン。結果の次のページの開始位置を指定します。これ以上の結果がない場合、この項目は空になります。offset: 特定のページの上部に返される求人の関連性ランキングと 1（返される最も関連性の高い求人）の間のオフセットを指定します。例として、ユーザーが検索を実行し、pageSizeが 10 に設定されます。最初のページは一番上の求人を返すため、このページのoffset値は 0 です。次のページでは、上部にジョブ #11 が返されます。このページのoffsetは 10 です。
待ち時間の問題を回避するために、ページサイズを 20 結果以下に設定します。ベスト プラクティスとして、求職者に表示されるページごとに個別の検索呼び出しを発行します。代わりに、単一の検索呼び出しでより多くのジョブを返し、クライアント側でページ分けを行うと、機械学習モデルが Jobs Analytics Framework を介して正確に学習する能力が妨げられます。
スペルチェック
スペルチェックは、スペルが誤っている可能性のある検索キーワードを識別して修正し、修正されたクエリに基づいて結果を返す Cloud Talent Solution の検索リクエストの機能です。たとえば、スペルチェックが有効である場合は、求職者が「manager」ではなく「manaer」を検索しても、Cloud Talent Solution は「manager」の求人を返します。スペルチェックは、JobQuery の disableSpellCheck フィールドを設定することで有効化や無効化が行えます。スペルチェックが有効になっている場合、修正されたクエリは、検索応答の spellResult フィールドに入ります。