ATS と Indeed エントリーの連携

採用管理システム（ATS）パートナー向けに Indeed エントリーと連携します。

 

法的注意

• この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。

概要

この手順は、Indeed の採用管理システム（ATS）パートナーが 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 token。API トークンを生成するをご覧ください。

開発とデプロイにかかる目安時間

連携済みパートナーとの実績では、このプロセスには通常約 6 週間かかります。これには、設定、テスト、Indeed とのレビュー、およびクライアント導入に向けたデプロイが含まれます。

XML 連携では、一定のスケジュールで XML フィードを Indeed に設定して公開します。これにより、Indeed 上で主要な求人詳細をどのように表示するかを制御できます。Indeed.com で Indeed エントリーを有効にするには、フィード内の各求人にメタデータを追加します。このメタデータによって、Indeed エントリーのフローにスクリーナー質問が表示され、Indeed が候補者情報の送信先を把握できます。

Indeed エントリーのメタデータと任意のスクリーナー質問を含めて XML フィードを設定すると、Indeed はそのフィードを技術品質とポリシー準拠の観点でレビューします。

フィードの公開と更新の方法を選択し、Indeed からのフィードバックと必要な修正を確認するには、Indeed Integrations Delivery チームと連携してください。

ロードマップ

次の XML フィードベースの連携手順を完了してください。

1. API トークンを生成する
2. XML フィードを作成する
3. 求人で Indeed エントリーを設定する
4. Indeed エントリーのスクリーナー質問を追加する
5. Indeed から応募データを受信する
6. Indeed エントリー設定をテストする
7. 連携の健全性を監視する
8. XML フィードをレビューに提出する
9. 応募者ステータスデータを Indeed に送信する

API トークンを生成する

Indeed パートナーになると、Indeed は Indeed API とサービスを貴社製品に接続するアプリをセットアップします。アプリとその Indeed エントリー API token 認証情報を表示するには、Partner Console にサインインしてください。API token 認証情報は client ID と secret です。この API token は、Indeed に投稿する各求人に指定してください。

XML フィードを作成する

ATS 用に Indeed エントリーを設定するには、XML feed を作成し、維持してください。この XML ドキュメントは、求人と、それらが Indeed 上でどのように表示されるかを定義します。

顧客が貴社システム内で求人一覧を作成すると、XML フィードはその一覧を Indeed に直接送信します。

XML フィードには次のものが含まれます。

XML feed

項目	定義する内容
基本フィードノード	XML バージョン、エンコーディング、ATS 情報など、XML フィードの一般的な詳細です。
求人フィード要素	求人固有の詳細です。Indeed に表示する各求人について、これらの要素を 1 セット含めます。

createSourcedJobPostings ミューテーションまたは XML job feed を通じて求人を作成した場合、その求人を期限切れにするには、お客様側で対応する必要があります。該当の求人は明示的に期限切れにする必要があります。

他のユーザーが updateSourcedJobPostings ミューテーションを呼び出した場合や、この求人の Indeed 求人詳細ページで Edit をクリックした場合でも、その求人は明示的に期限切れにする必要があります。

関連項目:

• createSourcedJobPostings
• XML job feed
• updateSourcedJobPostings
• Indeed job details page

Job Sync XML feed reference をご覧ください。

求人で Indeed エントリーを設定する

求職者が Indeed からすばやく応募できるようにするには、Indeed エントリーを通じて かんたん応募 機能を使用します。

かんたん応募 が有効な求人は、クリック数が 12% 多くなります。Indeed エントリーでは、求職者が Indeed Resume を使用できるため、応募プロセスが簡単になります。

求人で Indeed エントリーを設定するには、次の手順に従ってください。

1. XML フィード内の求人に対して、<indeed-apply-data> 要素に Indeed エントリー設定パラメーターを追加します。
2. <indeed-apply-postUrl> パラメーターで postUrl の値を設定し、Indeed からの応募を受け取れるようにします。
3. システムが応募データを解析して処理できることを確認します。

設定パラメーターについては、Indeed エントリー設定パラメーターをご覧ください。

<indeed-apply-data> 要素については、Indeed エントリーの XML feed with <indeed-apply-data> 要素の例をご覧ください。

かんたん応募 について詳しくは、Policy - Indeed Apply と What does easily apply mean? をご覧ください。

Indeed エントリーのスクリーナー質問を追加する

スクリーナー質問を使用すると、雇用主は応募者が基準を満たしているかどうかをすばやく判断できます。雇用主がスクリーナー質問を追加すると、候補者とのやり取りにより多くの時間を使えます。

Indeed はスクリーナー質問をホストしません。システムがスクリーナー質問をサポートしている場合、連携の承認を得るには、Indeed エントリー用に実装する必要があります。

Indeed エントリーのフローにスクリーナー質問を表示するには、次のいずれかを行います。

• 質問を JSON 形式で記述し、HTTPS URL でホストして、その URL を <indeed-apply-data> 要素配下の <indeed-apply-questions> パラメーターで各 <job> に含めます。

  詳しくは、次をご覧ください。

  • Indeed エントリーの XML feed with <indeed-apply-data> 要素の例
  • Indeed エントリー設定リファレンス

• Job Sync API を呼び出して、スクリーナー質問付きの求人掲載を作成します。

2024 年 1 月に、Indeed はスクリーナー質問設定に schema version を導入しました。Indeed は機能を追加するたびに minor version を更新します。応募 payload では schema version が 1.X として表示されます。たとえば 1.1 や 1.2 です。major または minor のアップグレード時に連携が壊れないよう、この値は柔軟に扱ってください。スクリーナー質問 JSON の minor schemaVersion を一致させる必要はありません。

考慮事項

• 質問は最大 500 件まで設定できます。

  データでは、20 件を超える質問を設定するとコンバージョンが大きく低下します。

• 質問ファイルのサイズは最大 1 MB です。

• 一意の質問 URL はサーバーでキャッシュされます。Indeed は 24 時間ごとに更新します。キャッシュが 1 時間を超えた後に新しいリクエストが到着した場合は、それより早く更新されます。

• 履歴書標準化サポートを実装し、Question URL の内容である JSON データを変更する場合は、キャッシュをクリアするために新しい URL に切り替えてください。

• Indeed は、求人説明や応募プロセス中に不要な個人を特定できる情報（PII）を雇用主が要求することを許可していません。詳しくは、Policy - Personally Identifiable Information (PII) をご覧ください。

求職者が Indeed エントリーのプロセスを開始し、Indeed が質問をリクエストすると、Indeed はその質問をキャッシュします。

スクリーナー質問の JSON

各質問タイプのパラメーター一覧と例については、スクリーナー質問をご覧ください。

Indeed から応募データを受信する

Indeed から応募データを受信するには、各求人についてフィード内で URL を指定します。

Indeed はその URL に、その求人の候補者情報を JSON ドキュメントとして送信します。

応募配信

応募をプログラムで処理するには、Indeed エントリーからの POST リクエストを受け付ける URL を指定します。<indeed-apply-postUrl> パラメーターは、Indeed が応募データを送信する URL を定義する文字列です。この URL では HTTPS を使用する必要があります。

postUrl の例

indeed-apply-postUrl=https%3A%2F%2Fyourposturl.com

正常に受信したすべての応募について、システムが HTTP 2XX ステータスコードを返すことを確認してください。Indeed エントリーは、それ以外の HTTP ステータスコード、POST timeout、または接続 timeout を失敗として扱います。

接続 timeout、POST timeout、または無効な HTTP レスポンスにより Indeed が HTTP 2XX ステータスコードを受信できない場合、Indeed は応募を再試行します。Indeed は自動再試行に指数バックオフを使用します。最後の再試行後も配信に失敗した場合、Indeed はその応募を terminal failure として扱います。

POST 中に求人応募コンテンツを検証しないでください。コンテンツを検証して応募者を不合格にしたい場合は、POST の後で行ってください。パートナー側の検証によって求職者データの HTTP 失敗が発生した場合、Indeed はその会社、またはフィード全体で Indeed エントリーを無効にすることがあります。

応募配信リファレンスをご覧ください。

301 や 302 レスポンスなどで POST リクエストを別の URL にリダイレクトしないでください。Indeed エントリーはリダイレクトをサポートしていません。

重複応募

POST に応答する際、応募を重複として扱うのは、次の両方を満たす場合だけにしてください。

• 同じ求人 ID を使用している。
• 過去 120 日以内の Indeed 応募と同じ求職者メールアドレスを使用している。

重複かどうかを判断する際に、もともと別のソースから送信された応募は使用しないでください。同じ会社の別の求人 ID に同じ求職者メールアドレスで応募した場合も、重複として扱わないでください。

応募データ

Indeed は応募データを HTTP POST リクエストの raw body として送信するため、一般的なフォームのようには処理できません。リクエスト body には、読み取りと解析が必要な JSON ドキュメントが含まれます。Indeed はすべての JSON フィールドを毎回送信するわけではないため、欠落フィールドを空として扱い、認識できないフィールドを無視する堅牢な JSON パーサーを使用してください。

JSON payload に最大サイズはありません。

POST body は UTF-8 でエンコードされており、Indeed が応募を送信したことを検証するのに役立つ authenticity header が含まれています。

Applicant フィールドの file セクションには、contentType、data、fileName が含まれます。

Indeed は fileName から contentType を判断します。

data フィールドには、Base64 エンコードされた raw の履歴書ファイルが含まれます。

システムは次のファイルタイプをサポートする必要があります。.txt、.pdf、.doc、.docx、.rtf。

システムが提供された履歴書の別バージョンをすでに保存している場合でも、応募 JSON から取得した更新版を保存して使用する必要があります。

応募データの詳細については、応募データリファレンスをご覧ください。

POST リクエストの認証

Indeed エントリーは postUrl に POST リクエストを送信します。このリクエストには、その POST が真正であることを検証するために使用できる HTTP header が含まれます。

Indeed は、Indeed エントリー認証情報タイプ用の共有 API secret を使用し、HMAC-SHA1 アルゴリズムで message signature を計算します。Indeed はこの signature を HTTP X-Indeed-Signature header で送信します。

signature の生成には、中括弧（{}）を含む変更されていない完全な JSON payload と共有 secret を使用します。

Indeed が message signature をどのように生成するかを示すコード例については、メッセージシグネチャ生成リファレンスをご覧ください。

サポートされている SSL 証明書

サポートされている証明書については、Trusted root SSL certificates をご覧ください。

証明書が一覧にない場合は、Integrations Delivery Team にお問い合わせください。

Indeed エントリー設定をテストする

Indeed は、Indeed エントリー連携の各コンポーネントをテストできる複数のツールを提供しています。

連携の問題を特定し、事前に修正するために、利用できるテストツールとリソースについて、これらのトピックを確認してください。

Indeed エントリー応募フローと応募者配信をテストする

求人または連携を公開する前に、連携設定をテストしてすべてが正しく動作することを確認するには、Apply XML configuration testing tool を使用してください。

このツールには、ある求人の Indeed エントリー XML メタデータを入力することも、設定可能なパラメーターからツールに XML メタデータを生成させることもできます。このツールは書式と内容のエラーを特定するため、問題をすばやく見つけられます。

エラーが検出されない場合、このツールには Start testing ボタンが表示されます。これを選択すると、応募体験を確認し、テスト応募を送信してプロセスが正しく動作することを検証できます。postUrl が有効であれば、このツールは応募データ payload を含むテスト応募を postUrl に送信します。そのテスト応募を使用して、システムが JSON ドキュメントを正しく解析し、応募者情報が想定どおりにシステムに表示されることを確認できます。

Indeed エントリー XML メタデータをテストする

Indeed エントリー XML 設定テストツールの最初のタブでは、XML から Indeed エントリーのメタデータを入力し、Indeed エントリーの応募フローで確認できます。このタブの Configuration セクションには、XML に含まれるすべてのパラメーターも一覧表示されるため、検出された求人要素を確認できます。

サポートされているパラメーターについては、Indeed エントリー設定リファレンスを参照してください。

Indeed エントリー XML 設定テストツール - XML タブ

Indeed エントリー XML 設定テストツール - XML タブ

このツールでは、Indeed エントリーを正常に動作させなくなる可能性があるメタデータ内のエラーも検出されます。たとえば、必須パラメーターの不足や、ファイル形式の誤りを検出します。いずれの場合も、ツールにアラートが表示されます。

例: パラメーター形式が正しくない場合のエラー

例: パラメーター形式が正しくない場合のエラー

例: パラメーターが不足している場合のエラー

例: パラメーターが不足している場合のエラー

Indeed エントリー XML 設定テストツールの 2 つ目のタブでは、設定可能なパラメーターを入力し、対応する Indeed エントリー XML メタデータを生成できます。入力した情報に基づいて、応募フロー内で求人がどのように表示されるかをプレビューすることもできます。

ツールでメタデータを生成したら、それを XML フィードに追加します。例については、XML フィードを作成するを参照してください。

Indeed エントリー XML 設定テストツール - 設定可能なパラメーター タブ

Indeed エントリー XML 設定テストツール

デフォルトのパラメーターに加えて、オプションの一覧から追加のパラメーターを選択できます。選択して入力すると、ツールはそれらを生成される XML に追加します。

このツールを使用すると、Indeed エントリー連携をモックアップできます。Indeed エントリータグ内に postUrl を指定すると、応募体験を一通り確認しながら、ツールのサンプルデータで指定した URL に応募を送信できます。

Indeed エントリーのスクリーナー質問をテストする

Indeed エントリー質問ツールを使用して、スクリーナー質問 JSON ファイルの構文を検証することもできます。このツールでは、Indeed エントリーの応募フローでスクリーナー質問がどのように表示されるかを確認できます。

Indeed Apply Questions tool

Indeed Apply Questions tool

このインタラクティブツールの main field に JSON ファイル全体を貼り付けると、書式エラーが強調表示されます。

エラーメッセージの例

Error message examples

エディター上で右クリックすると、基本的なテキストコマンドを実行できます。

基本的なテキストコマンド

Basic text commands

より高度なコマンドを使うには、VS Code と同様に Command Palette を開くか、F1 を押してください。

より高度なコマンド

More advanced commands

このツールには、このドキュメントへのリンクも含まれているため、必要に応じて関連する JSON パラメーターを確認できます。

JSON の書式が正しいことを確認したら、Start testing を選択して、スクリーナー質問が求職者にどのように表示されるかをプレビューしてください。

連携の健全性を監視する

Indeed エントリーと連携する場合は、次の点を確認するための監視を設定してください。

• 連携が求人応募を正常に配信している。
• 質問ファイルが有効で、常に利用可能である。

Indeed は、応募が代理店プラットフォームまたは第三者プラットフォームに正常に配信されているかどうか、およびその他の連携の健全性指標も監視します。問題が発生した場合、Indeed から連絡することがあります。場合によっては、問題を修正するまで、Indeed はフィード内の一部またはすべての求人掲載に対して Indeed エントリーを無効にすることがあります。配信されなかった応募は失われません。配信に失敗した場合、Indeed は元の送信後、一定間隔で自動的に再試行します。それでも配信できない場合、Indeed は応募を 60 日間保持します。Integrations Delivery Team に依頼すると、追加の再試行をリクエストできます。

連携がスクリーナー質問をサポートしている場合は、それらのファイルをホストしているページが利用可能であり、リダイレクトせず、正しい形式を使用していることを確認してください。

XML フィードをレビューに提出する

開発が完了したら、レビューのために XML フィードを技術担当窓口に提出するか、Partner Console を通じてサポートをリクエストしてください。

応募者ステータスデータを Indeed に送信する

応募者ステータスデータ は、ATS 内の応募に対する更新を表します。

更新には、リクルーターのワークフローの変更や、候補者の応募後にリクルーターまたは候補者が行うアクションが含まれます。たとえば、候補者が採用されることです。

応募者ステータスデータを Indeed に送信すると、クライアントは時間とともに、より質の高い応募を受け取れるようになります。

Disposition Sync API Guide をご覧ください。

 

このページは役に立ちましたか？