ATSパートナー向けIndeed エントリー連携ガイド
採用管理システム（ATS）パートナー向けにIndeed エントリーと連携します。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
連携の概要
#このガイドは、採用管理システム（ATS）パートナー向けです。
ATSをIndeed エントリーと連携すると、クライアントは求人でカンタン応募を有効にでき、Indeedは応募者をクライアントのATSに送信します。Indeed エントリーは求職者の応募を容易にし、クライアントがより早く採用できるよう支援します。
Indeed エントリーと連携するには、次のものが必要です。
- 貴社とIndeedの間で締結された署名済みのDeveloper Agreement。各連携リクエストは、Become an Indeed partner （新しいウィンドウで開きます）から送信してください。
- 貴社のシステムを把握し、HTTP、XML、JSONを理解しているソフトウェア開発者。
- XMLフィードを公開して更新する手段。たとえばFTPです。
- 審査用の質問をHTTPS URLに公開する手段。
- Indeed エントリーのAPIトークン。
連携では、設定、テスト、Indeedとのレビュー、デプロイまで通常約6週間かかります。
XML連携では、XMLフィードを定期的にIndeedに公開します。このフィードによって、求人詳細がIndeed上でどのように表示されるかが決まります。Indeed エントリーを有効にするには、各求人にIndeed エントリーのメタデータを追加します。このメタデータは、応募に審査用の質問を追加し、候補者情報の送信先をIndeedに伝えます。
メタデータと任意の審査用の質問を追加すると、Indeedはそのフィードを技術品質とポリシー準拠の観点でレビューします。
フィードの公開方法と更新方法を選択し、フィードバックと必要な修正を確認するには、Indeed Integrations Delivery （新しいウィンドウで開きます）チームと連携してください。
連携手順
#1. APIトークンを生成する
#Indeedパートナーになると、Indeedは貴社の連携用のアプリを作成します。アプリのIndeed エントリーの認証情報（client IDとsecret）を表示するには、Partner Console （新しいウィンドウで開きます）にサインインしてください。client IDがIndeed エントリーのAPIトークンです。このトークンは、Indeedに投稿する各求人に含めてください。
2. XMLフィードを作成する
#Indeed エントリーを設定するには、XMLフィードを作成して維持します。XMLフィードは、求人と、それらがIndeed上でどのように表示されるかを定義するXMLドキュメントです。
クライアントが貴社システムで求人を作成すると、XMLフィードがそれらの求人をIndeedに送信します。
XMLフィードには次のものが含まれます。
| 項目 | 定義する内容 |
|---|---|
基本フィードノード | XMLバージョン、エンコーディング、ATS情報など、フィードの一般的な詳細です。 |
求人フィード要素 | 求人固有の詳細です。Indeedに表示する各求人について、1セット含めます。 |
createSourcedJobPostings ミューテーションまたは XML フィードを通じて求人を作成した場合、その求人を期限切れにするには、お客様側で対応する必要があります。該当の求人は明示的に期限切れにする必要があります。
他のユーザーが updateSourcedJobPostings ミューテーションを呼び出した場合や、この求人の Indeed 求人詳細ページで Edit をクリックした場合でも、その求人は明示的に期限切れにする必要があります。
関連項目:
3. 求人でIndeed エントリーを設定する
#求職者がIndeedからすばやく応募できるようにするには、Indeed エントリーでカンタン応募を有効にします。
カンタン応募が有効な求人は、クリック数が12%多くなります。求職者はIndeedの履歴書を使って応募することもできます。
求人でIndeed エントリーを設定するには:
- 1.XMLフィードの各求人について、
<indeed-apply-data>要素にIndeed エントリーの設定パラメータを追加します。 - 2.Indeedが応募を貴社システムに送信できるよう、
<indeed-apply-postUrl>でpostUrlを設定します。 - 3.システムが応募データを解析できることを確認します。
4. Indeed エントリーの審査用の質問を追加する
#審査用の質問により、採用企業は応募者が基準を満たしているかどうかを確認できるため、選考にかける時間を減らし、候補者と向き合う時間を増やせます。
Indeedは審査用の質問をホストしません。システムが審査用の質問をサポートしている場合は、Indeedが連携を承認する前に、Indeed エントリーに追加する必要があります。
Indeed エントリーに審査用の質問を追加するには、次のいずれかを行います。
-
質問をJSONとしてHTTPS URLでホストします。各
<job>で、そのURLを<indeed-apply-data>内の<indeed-apply-questions>に指定します。 -
審査用の質問付きで求人を作成するために、求人情報連携APIを呼び出します。
2024年1月以降、審査用の質問の設定にはスキーマバージョンがあります。Indeedは機能を追加するとマイナーバージョンを上げます。応募ペイロードでは、バージョンが1.1や1.2のように1.Xとして表示されます。バージョンのアップグレードで連携が壊れないよう、この値をハードコードしないでください。審査用の質問のJSONは、マイナーのschemaVersionと一致させる必要はありません。
考慮事項
#-
質問は最大500件まで設定できます。
質問が20件を超えると、コンバージョンが大きく低下します。
-
質問ファイルのサイズは最大1 MBです。
-
Indeedは一意のURLごとに質問ファイルをキャッシュします。キャッシュは24時間ごとに、またはキャッシュが1時間以上経過した時点で新しいリクエストが届いた場合はそれより早く更新されます。
-
JSONを変更した後や履歴書フィールドの標準化を追加した後にキャッシュをクリアするには、新しい質問URLを使用してください。
-
採用企業は、求人説明や応募で、不要な個人を特定できる情報（PII）を求めることはできません。
審査用の質問のJSONリファレンス
#質問タイプのパラメータ一覧と例については、審査用の質問をご覧ください。
5. Indeedから応募データを受信する
#応募データを受信するには、フィード内で各求人にURLを指定します。IndeedはそのURLに、該当する求人の候補者情報をJSONとして送信します。
応募配信
#応募を自動的に処理するには、Indeed エントリーからのPOSTリクエストを受け付けるURLを使用します。このURLは<indeed-apply-postUrl>パラメータで設定します。URLではHTTPSを使用する必要があります。
postUrlの例
#indeed-apply-postUrl=https%3A%2F%2Fyourposturl.comシステムが受信したすべての応募に対して、HTTP 2XXステータスコードを返してください。Indeed エントリーは、それ以外のステータスコード、POSTタイム アウト、または接続タイムアウトを失敗として扱います。
Indeedは2XXステータスコードを受信しなかった場合、指数バックオフで応募を再試行します。最後の再試行が失敗した場合、Indeedはその応募を失敗としてマークします。
POST中に応募内容を検証しないでください。応募内容を検証したり応募者を不適格にしたりする場合は、POSTを受け付けた後に行ってください。検証によってHTTPエラーが発生すると、Indeedはその会社またはフィード全体でIndeed エントリーを無効にすることがあります。
POSTリクエストを301や302などでリダイレクトしないでください。Indeed エントリーはリダイレクトをサポートしていません。
重複する応募
#POSTに応答するときに応募を重複として扱うのは、次の両方に当てはまる場合だけです。
- 同じ求人IDを使用している。
- 過去120日以内のIndeedからの応募と同じ求職者メールアドレスを使用している。
Indeed以外のソースからの応募は数えないでください。同じメールアドレスから同じ会社の別の求人IDへの応募は重複ではありません。
応募データ
#Indeedは応募データをPOSTリクエストの生のボディにJSONドキュメントとして送信するため、システムは一般的なフォームのようには処理できません。JSONを読み込んで解析してください。すべての応募にすべてのフィールドが含まれるわけではないため、欠落したフィールドを空として扱い、認識できないフィールドを無視するJSONパーサーを使用してください。
JSONペイロードに最大サイズはありません。
POSTボディはUTF-8でエンコードされています。リクエストには、Indeedが送信したことを検証できるヘッダーが含まれます。
Applicantフィールドのファイル部分には、contentType、data、fileNameが含まれます。
IndeedはcontentTypeをfileNameから判定します。
dataフィールドには、Base64エンコードされた履歴書ファイルの生データが含まれます。
システムは次のファイルタイプに対応する必要があります。.txt、.pdf、.doc、.docx、.rtf。
候補者の履歴書の保存済みバージョンがすでにシステムにある場合は、代わりに応募JSON内のバージョンを保存して使用してください。
応募データの詳細については、応募データリファレンスをご覧ください。
POSTリクエストの認証
#postUrlへの各POSTリクエストには、リクエストが正当であることを検証できるHTTPヘッダーが含まれます。
Indeedは、HMAC-SHA1アルゴリズムとIndeed エントリーの共有APIシークレットを使用してメッセージ署名を計算し、X-Indeed-Signatureヘッダーで送信します。
署名の対象は、中括弧（{}）を含む、未変更のJSONペイロード全体です。
コード例については、メッセージシグネチャ生成リファレンスをご覧ください。
サポートされているSSL証明書
#サポートされている証明書については、信頼されたルートSSL証明書をご覧ください。
証明書が一覧にない場合は、Integrations Delivery Team （新しいウィンドウで開きます）に連絡してください。
6. Indeed エントリーの設定をテストする
#Indeed は、Indeed エントリー連携のコンポーネントをテストするツールを提供しています。これらのトピックを確認して、利用できるツールを把握し、連携の問題を早い段階で修正してください。
Indeed エントリーの応募フローと応募者配信をテストする
#求人または連携を公開する前に、Apply XML configuration testing tool （新しいウィンドウで開きます）で設定をテストしてください。
求人のIndeed エントリーXMLメタデータを入力するか、選択したパラメータからツールにメタデータを生成させます。ツールは書式と内容のエラーを検出します。
エラーが検出されない場合は、Start testingが表示されます。これを選択すると、応募体験を確認し、テスト応募を送信できます。postUrlが有効であれば、ツールはそのURLにテスト応募のペイロードを送信します。これを使って、システムがJSONを解析し、応募者情報が想定どおりに表示されることを確認してください。
Indeed エントリーのXMLメタデータをテストする
#Indeed エントリー XML 設定テストツールの最初のタブでは、XML から Indeed エントリーのメタデータを入力し、応募フローで確認できます。Configuration セクションには、XML 内のすべてのパラメーターが一覧表示されるため、検出された求人要素を確認できます。
サポートされているパラメーターについては、Indeed エントリー設定リファレンスをご覧ください。
Indeed エントリー XML 設定テストツール - XML タブ
#このツールは、必須パラメーターの不足やファイル形式の誤りなど、Indeed エントリーが正常に動作しなくなる可能性があるメタデータのエラーも検出します。いずれの場合も、ツールにアラートが表示されます。
例: パラメーター形式が正しくない場合のエラー
#例: パラメーターが不足している場合のエラー
#2 つ目のタブでは、設定可能なパラメーターを入力すると、対応する Indeed エントリー XML メタデータが生成されます。応募フローで求人がどのように表示されるかをプレビューすることもできます。
ツールがメタデータを生成したら、それを XML フィードに追加します。例については、XML フィードを作成するをご覧ください。
Indeed エントリー XML 設定テストツール
#デフォルトのパラメーターに加えて、オプションの一覧から追加できます。選択して入力すると、ツールはそれらを生成される XML に追加します。
このツールを使用すると、Indeed エントリー連携をモックアップできます。Indeed エントリータグ内に postUrl を指定すると、応募体験を一通り確認し、ツールのサンプルデータを使用してその URL に応募を送信できます。
Indeed エントリーの審査用の質問をテストする
#Indeed Apply Questions tool （新しいウィンドウで開きます） を使用して、審査用の質問 JSON の構文と、質問が Indeed エントリーのフローでどのように表示されるかを確認してください。
Indeed Apply Questions tool
#JSONファイル全体をメインフィールドに貼り付けると、書式エラーが強調表示されます。
エラーメッセージの例
#エディター上で右クリックすると、基本的なテキストコマンドを実行できます。
基本的なテキストコマンド
#VS Codeにあるようなより高度なコマンドを使うには、Command Paletteを開くか、F1を押してください。
より高度なコマンド
#このツールにはこのドキュメントへのリンクもあるため、JSONパラメータを調べることができます。
JSONにエラーがなくなったら、Start testingを選択して、審査用の質問を求職者としてプレビューしてください。
7. 連携の正常性を監視する
#次の内容を確認する監視を設定してください。
- 連携が求人応募を正常に配信している。
- 質問ファイルが有効で、常に利用可能である。
Indeedも、応募の配信とその他の連携の正常性指標を監視しています。問題が発生した場合、Indeedから連絡することがあります。場合によっては、問題を解決するまで、Indeedはフィード内の一部またはすべての求人でIndeed エントリーを無効にします。
Indeedは未配信の応募を失いません。配信に失敗した場合、Indeedは自動的に再試行します。それでも配信できない場合、Indeedは応募を60日間保持します。追加の再試行をリクエストするには、Integrations Delivery Team （新しいウィンドウで開きます）に連絡してください。
連携で審査用の質問をサポートしている場合は、質問ファイルをホストするページが常に利用可能で、リダイレクトせず、正しくフォーマットされていることを確認してください。
8. XMLフィードをレビューに提出する
#開発が完了したら、XMLフィードを技術担当窓口に送ってレビューを依頼するか、Partner Consoleでサポートをリクエストしてください。
9. 応募者ステータスデータをIndeedに送信する
#応募者ステータスデータは、ATS内の応募に対する更新を表します。
更新とは、リクルーターのワークフローの変更、または採用など、候補者の応募後にリクルーターや候補者が行う操作です。
応募者ステータスデータを送信すると、クライアントは時間の経過とともに、より質の高い応募を受け取れるようになります。
応募者ステータス連携APIガイドをご覧ください。
関連項目
#ガイド
#- 応募配信リファレンス —
POSTレスポンスで返すHTTPステータスコードです。 - 応募者ステータス連携APIガイド — 応募者ステータスのデータをIndeedに送信します。
- Increase candidate quality, hire more efficiently （新しいウィンドウで開きます） — Indeed エントリーを利用して、より関連性の高い候補者をより早く獲得する方法です。
- Indeed エントリー設定パラメーターの制限事項 — XMLフィードでIndeed エントリーを設定するときに従う制限事項です。
- Indeed エントリー設定リファレンス — XMLフィードでIndeed エントリーを設定するためのパラメーター、例、制限事項です。
- Indeed Apply Policy （新しいウィンドウで開きます） — Indeed エントリーを使用すると、Indeed上で求人に直接応募できます。
- 求人情報連携APIガイド > 求人詳細ページ（Indeedにサインイン済み） — 求人詳細ページでの求人の検索可能ステータスの表示です。
- Job Sync XML フィードガイド — XMLフィードを使用して、求人とIndeedでの表示方法を定義します。
- 審査用の質問のJSONリファレンス — 審査用の質問をJSONで指定するためのパラメーターです。
- Maintaining User Safety （新しいウィンドウで開きます） — Indeedが求職者の安全を守り、個人情報を保護する方法です。
- メッセージシグネチャ生成リファレンス — メッセージシグネチャを生成するコードサンプルです。
- 信頼されたルート SSL 証明書 — Indeed エントリーが信頼するルートSSL証明書です。
- <indeed-apply-data>を含むXMLフィード — 1件の求人と
<indeed-apply-data>要素を含むフィードの例です。
GraphQL APIリファレンス
#createSourcedJobPostings— 求人をIndeedに送信します。updateSourcedJobPostings— ソース求人を更新します。先に求人ソースをクレームしてください。