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