代理店および第三者向けIndeed エントリー連携ガイド
Indeed エントリーと連携すると、クライアントは求人でカンタン応募を有効にし、応募者データを適切なプラットフォームに送信できます。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
連携の概要
これらの手順は代理店向けです。
代理店プラットフォームまたは第三者プラットフォームをIndeedと連携すると、クライアントは求人でカンタン応募を有効にし、応募者を適切なプラットフォームに送信できます。Indeed エントリーは求職者体験を改善し、クライアントがより早く採用できるよう支援します。
代理店プラットフォームまたは第三者プラットフォームをIndeed エントリーと連携するには、次のものが必要です。
- 貴社とIndeedの間で締結済みの開発者契約。1. Indeedと開発者契約を締結するをご覧ください。
- 貴社のシステムとHTTP、XML、JSONを理解している開発者。
- XMLフィードを公開および更新する手段。FTPなど。
- 求人の審査用の質問をHTTPS URLに公開する手段。
- Indeed エントリーAPIトークン。2. 認証するをご覧ください。
過去の連携では、設定、テスト、Indeedとのレビュー、展開まで通常6週間ほどかかっています。
XML連携では、XMLフィードを作成し、定期的にIndeedに公開します。このフィードは、クライアントの求人がIndeed上でどのように表示されるかを制御します。Indeed.comでIndeed エントリーを有効にするには、各求人にメタデータを追加します。このメタデータにより、Indeed エントリーのフローで審査用の質問が表示され、候補者情報を貴社システムのどこに送るかがIndeedに伝わります。
Indeed エントリーのメタデータと任意の審査用の質問を追加した後、Indeedはそのフィードを技術品質とポリシー準拠の観点からレビューします。
Indeed Integrations Deliveryチームと連携して、フィードの公開方法と更新方法を決め、フィードバックと必要な修正内容を確認してください。
連携手順
1. Indeedと開発者契約を締結する
Indeedと開発者契約を締結し、Indeedパートナーになるから連携リクエストを送信してください。
Indeedがアカウントを承認すると、アクセスが有効になり、連携に関するアンケートが送られま す。
2. 認証する
パートナーになると、IndeedはIndeedのAPIとサービスを貴社製品に組み込むためのアプリを作成します。Partner Consoleで、そのアプリのIndeed エントリーAPIトークンを取得してください。認証情報をご覧ください。
このAPIトークンは、Indeedに掲載する各求人に含めます。
3. XMLフィードを作成する
代理店プラットフォームまたは第三者プラットフォームでIndeed エントリーを設定するには、XMLフィードを作成して維持してください。XMLフィードは、貴社の求人と、それらがIndeedでどのように表示されるかを定義するXMLドキュメントです。
顧客が貴社システムで求人を作成すると、それらの求人は貴社のXMLフィードからIndeedに送られます。
XMLフィードには次のものが含まれます。
| 項目 | 定義 |
|---|---|
基本フィードノード | XMLバージョン、エンコーディング、代理店プラットフォームまたは第三者プラットフォームの詳細など、XMLフィードの一般情報です。 |
求人フィード要素 | 求人の詳細です。Indeedに表示する各求人について、これらの要素のセットを1つ含めます。 |
createSourcedJobPostings ミューテーションまたは XML フィードを通じて求人を作成した場合、その求人を期限切れにするには、お客様側で対応する必要があります。該当の求人は明示的に期限切れにする必要があります。
他のユーザーが updateSourcedJobPostings ミューテーションを呼び出した場合や、この求人の Indeed 求人詳細ページで Edit をクリックした場合でも、その求人は明示的に期限切れにする必要があります。
関連項目:
4. 求人でIndeed エントリーを設定する
求職者がIndeedで迅速に応募できるようにするには、Indeed エントリーでカンタン応募を有効にします。
カンタン応募の求人はクリックが12%増加します。求職者はIndeed Resumeで応募することもできます。
求人でIndeed エントリーを設定するには:
- XMLフィードの各求人の
<indeed-apply-data>要素に、Indeed エントリーの設定パラメータを追加します。 - Indeedが応募を貴社システムに送信できるよう、
<indeed-apply-postUrl>にpostUrlを設定します。 - 貴社システムが応募データを解析して処理できることを確認します。
関連情報:
- 設定パラメータについては、Indeed エントリー設定パラメータをご覧ください。
<indeed-apply-data>要素については、<indeed-apply-data>を含むXMLフィードの例をご覧ください。- カンタン応募について詳しくは、Policy - Indeed ApplyおよびWhat does easily apply mean?をご覧ください。
5. Indeed エントリーの審査用の質問を追加する
審査用の質問により、採用企業は応募者が要件を満たしているかをすばやく確認できるため、選考にかける時間を減らし、候補者とつながる時間を増やせます。
Indeedは審査用の質問をホストしません。貴社システムが対応している場合、連携が承認されるにはIndeed エントリーで実装する必要があります。
Indeed エントリーのフローで審査用の質問を表示するには、次のいずれかを行います。
-
質問をJSONとしてHTTPS URLでホストします。
そのURLを、各
<job>の<indeed-apply-data>内の<indeed-apply-questions>に指定します。 -
求人情報連携APIを呼び出して、審査用の質問付きで求人を作成します。
2024年1月、Indeedは審査用の質問の設定にスキーマバージョンを追加しました。新機能が追加されると、Indeedはマイナーバージョンを更新します。応募ペイロードでは、スキーマバージョンが1.X（1.1や1.2など）として表示されます。連携が壊れないよう、この値は柔軟に扱ってください。審査用の質問のJSONは、マイナーなschemaVersionと一致している必要はありません。
留意点
-
質問は最大500件までです。
20件を超えるとコンバージョンが大きく低下します。
-
質問ファイルは最大1 MBです。
-
Indeedは一意の質問URLについて質問ファイルをキャッシュします。24時間ごとに、またはキャッシュが1時間以上経過した後に新しいリクエストが届いた場合はそれより早く更新します。
-
Indeedは、求人の説明または応募プロセス中に、採用企業が不要な個人を特定できる情報（PII）を求めることを認めていません。詳しくは、Maintaining User Safetyをご覧ください。
求職者がIndeed エントリーを開始し、Indeedが質問をリクエストすると、Indeedはそれらの質問をキャッシュします。
関連情報:
6. Indeedから応募データを受信する
Indeedから応募データを受信するには、各求人のフィードにURLを指定します。
Indeedは、その求人の候補者情報をこのURLにJSONとして送信します。
応募の配信
応募をプログラムで処理するには、Indeed エントリーからのPOSTリクエストを受け付けるURLを指定します。
<indeed-apply-postUrl>パラメータがこのURLを定義します。HTTPSを使用する必要があります。
postUrlの例
_indeed-apply-postUrlシステムが正常に受信したすべての応募に対してHTTP 2XXステータスコードを返すことを確認してください。Indeed エントリーは、その他のHTTPステータスコード、POSTタイムアウト、または接続タイムアウトを失敗として扱います。
接続タイムアウ ト、POSTタイムアウト、または無効なHTTPレスポンスによりIndeedがHTTP 2XXステータスコードを受信しなかった場合、Indeedは応募を再試行します。Indeedは自動再試行に指数バックオフを使用します。最後の自動再試行後も配信に失敗した場合、Indeedはその応募を最終的に失敗とします。
パートナーは、POST中に求人応募の内容を検証しないでください。求人内容を検証して応募者を不適格にする場合は、POSTの下流で行ってください。求職者データのパートナー側検証がHTTP失敗の原因になると、応募が送信された企業、またはフィード全体でIndeed エントリーが無効になることがあります。
応募配信リファレンスをご覧ください。
POSTリクエストを、301や302リダイレクトなど別のURLにリダイレクトしないでください。Indeed エントリーはリダイレクトをサポートしません。
重複応募
POSTへの応答においては、同じ求人IDで、同じ求職者メールアドレスからのIndeed応募が過去120日以内にある場合にのみ、応募を重複として扱ってください。
POSTへの応答で重複かどうかを判断する際に、Indeed以外のソースから当初送信された応募を使用しないでください。同様に、同じ求職者メールアドレスから同じ企業の別の求人IDへの応募を重複として扱わないでください。
応募データ
Indeedは応募データをHTTP POSTリクエストの生の本文として送信するため、システムは通常のフォームのようにリクエストを処理できません。リクエスト本文には、システムが読み取って解析する必要があるJSONドキュメントが含まれます。IndeedはすべてのJSONフィールドを提供するわけではないため、欠落フィールドを空として扱い、未知のフィールドを無視する堅牢なJSONパーサーを使用してください。
JSONデータペイロードに最大サイズはありません。
POST本文はUTF-8エンコーディングを使用し、Indeedが応募を送信したことを検証できる真正性ヘッダーを含みます。
Applicantフィールドのファイル部分には、contentType、data、fileNameの各フィールドが含まれます。
IndeedはfileNameからcontentTypeを決定します。
dataフィールドには、Base64でエンコードされた生の履歴書ファイルが含まれます。
第三者は、.txt、.pdf、.doc、.docx、.rtfのファイルタイプをサポートする必要があります。
第三者がシステムに保存済みの履歴書をすでに持っている場合でも、応募JSON内の更新版を保存して使用する必要があります。
応募データの詳細については、応募データリファレンスをご覧ください。
POSTリクエストの認証
Indeed エントリーは、POSTが真正であることを検証できるHTTPヘッダー付きで、postUrlにPOSTリクエストを送信します。
Indeed エントリーの認証情報タイプの共有APIシークレットを使用して、IndeedはHMAC-SHA1アルゴリズムでメッセージ署名を計算します。Indeedはこの署名をHTTP X-Indeed-Signatureヘッダーとして送信します。
署名を生成するため、Indeed エントリーは、中括弧（{}）を含む変更していないJSONペイロード全体と共有シークレットを使用します。
メッセージ署名の生成方法を示すコード例については、メッセージシグネチャ生成リファレンスをご覧ください。
サポートされるSSL証明書
サポートされる証明書については、信頼されたルートSSL証明書をご覧ください。
証明書がリストにない場合は、Integrations Delivery Teamにお問い合わせください。
7. Indeed エントリーの設定をテストする
Indeed は、Indeed エントリー連携のコンポーネントをテストするツールを提供しています。これらのトピックを確認して、利用できるツールを把握し、連携の問題を早い段階で修正してください。
Indeed エントリーの応募フローと応募者配信をテストする
連携設定をテストし、求人または連携を本番に出す前にすべてが円滑に動作することを確認するには、Apply XML configuration testing toolを使用します。
求人のIndeed エントリーXMLメタデータをツールに入力するか、いくつかの設定可能なパラメータからツールにXMLメタデータを生成させることができます。ツールはフォーマットと内容のエラーを特定するため、問題をすばやく見つけられます。
ツールがエラーを検出しない場合、Start testingボタンが表示されます。これを選択すると、求職者として応募プロセスをプレビューし、テスト応募を送信してプロセスが正しく動作することを確認できます。postUrlが有効であれば、応募データペイロード付きでpostUrlに送信されたテスト応募により、 システムが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を選択して、審査用の質問が求職者にどのように表示されるかをプレビューします。
8. 連携の状態を監視する
Indeed エントリーと連携する際は、次を確認する監視を設定してください。
- 連携が求人応募を正常に配信すること。
- 質問ファイルが有効で、常に利用できること。
Indeedも、応募が代理店プラットフォームまたは第三者プラットフォームに正常に到達しているか、その他の連携状態の指標を監視します。問題が発生した場合、Indeedから連絡することがあります。場合によっては、問題を修正するまで、フィードの一部 またはすべての求人でIndeed エントリー機能を無効にすることがあります。Indeedは未配信の応募を失いません。配信に失敗した場合、Indeedは元の応募送信後、定期的な間隔で自動的に再試行します。配信が引き続き不可能な場合、Indeedは応募を60日間保持します。Integrations Delivery Teamに連絡して、追加の再試行を依頼できます。
連携が審査用の質問に対応している場合は、それらのファイルをホストするページが常に利用でき、リダイレクトせず、正しくフォーマットされていることを確認してください。
9. XMLフィードをレビューに提出する
開発が完了したら、技術担当の連絡先にXMLフィードをレビュー用に提出するか、Partner Consoleからサポートをリクエストしてください。
10. 応募者ステータスデータをIndeedに送信する
応募者ステータスデータは、代理店プラットフォームまたは第三者プラットフォーム内の応募に対する更新に関する情報です。
更新とは、リクルーターのワークフロー の変更、または候補者の応募後にリクルーターや候補者が行う操作です。たとえば、候補者が採用される場合です。
応募者ステータスデータをIndeedに送信すると、クライアントは時間の経過とともに質の高い応募を受け取りやすくなります。
応募者ステータス連携APIガイドをご覧ください。