代理店および第三者プラットフォームとIndeed エントリーの連携

Indeed エントリーと連携すると、クライアントは求人でかんたん応募を有効にし、応募者データを適切なプラットフォームに送信できます。

 

法的注意

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

概要

これらの手順は代理店向けです。

代理店プラットフォームまたは第三者プラットフォームをIndeedと連携すると、クライアントは求人でかんたん応募を有効にし、応募者情報を適切なプラットフォームに送信できます。Indeed エントリーは求職者体験を改善し、クライアントがより早く採用できるよう支援します。

連携を開始する前に、貴社はIndeedとIndeed Partner Developer Agreementを締結している必要があります。

要件

代理店プラットフォームまたは第三者プラットフォームをIndeed エントリーと連携するには、次のものが必要です。

• 貴社とIndeedの間で締結済みの開発者契約。すべての連携は、Indeedパートナーになるの正式なリクエストプロセスを通す必要があります。
• 貴社のシステムとHTTP、XML、JSONを理解している開発者。
• XMLフィードを公開および更新する手段。FTPなど。
• 求人のスクリーナー質問をHTTPS URLに公開する手段。
• Indeed エントリー APIトークン。APIトークンを生成するをご覧ください。

開発および展開にかかる目安期間

過去の連携実績に基づくと、このプロセスでは、設定、テスト、Indeedとのレビュー、展開まで通常6週間ほどかかります。

XML連携では、XMLフィードを作成し、定期的にIndeedに公開する必要があります。このフィードにより、クライアントの求人がIndeed上でどのように表示されるかを制御できます。Indeed.comでIndeed エントリーを有効にするには、フィード内の各求人にメタデータを追加します。このメタデータにより、Indeed エントリーのフローでスクリーナー質問を表示し、候補者情報を貴社システムのどこに送るかを定義できます。

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トークン認証情報を確認するには、Partner Consoleにサインインしてください。

APIトークン認証情報はクライアントIDとシークレットです。このAPIトークンは、Indeedに掲載する各求人に含めます。

XMLフィードを作成する

代理店プラットフォームまたは第三者プラットフォームでIndeed エントリーを設定するには、XMLフィードを作成して維持してください。XMLフィードは、貴社の求人と、それらがIndeedでどのように表示されるかを定義するXMLドキュメントです。

顧客が貴社システムで求人を作成すると、それらの求人は貴社のXMLフィードからIndeedに送られます。

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

XMLフィード

項目	定義
基本フィードノード	XMLバージョン、エンコーディング、代理店プラットフォームまたは第三者プラットフォームの詳細など、XMLフィードの一般情報です。
求人フィード要素	求人の詳細です。Indeedに表示する各求人について、これらの要素のセットを1つ含めます。

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

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

関連項目:

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

Job Sync XMLフィードリファレンスをご覧ください。

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

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

かんたん応募の求人はクリックが12%増加します。Indeed エントリーでは、求職者がIndeed Resumeで応募できるため、プロセスが簡単になります。

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

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

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

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

かんたん応募について詳しくは、ポリシー - Indeed エントリーおよびかんたん応募とは？をご覧ください。

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

スクリーナー質問は、雇用主が応募者が要件を満たしているかをすばやく判断するのに役立ちます。スクリーニングにかける時間を減らし、候補者とつながる時間を増やすことができます。

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

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

• 質問をJSONでフォーマットし、HTTPS URLでホストします。そのURLを各<job>の<indeed-apply-data>内の<indeed-apply-questions>パラメータに含めます。

  詳細については、次をご覧ください。

  • Indeed エントリーのXMLフィードと<indeed-apply-data>
  • Indeed エントリー設定リファレンス

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

2024年1月、Indeedはスクリーナー質問設定のスキーマバージョンを導入しました。新機能が追加されると、Indeedはマイナーバージョンを更新します。応募ペイロードでは、スキーマバージョンが1.X（1.1や1.2など）として表示されます。連携が壊れないよう、この値は柔軟に扱ってください。スクリーナー質問のJSONは、マイナーなschemaVersionと一致している必要はありません。

留意点

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

  20件を超えるとコンバージョンが大きく低下します。

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

• Indeedは一意の質問URLについて、サーバー上で質問ファイルをキャッシュします。24時間ごとに、またはキャッシュが1時間以上経過した後に新しいリクエストが届いた場合はそれより早く更新します。

• Indeedは、求人の説明または応募プロセス中に、雇用主が不要な個人識別情報（PII）を求めることを許可しません。詳しくは、ポリシー - 個人識別情報（PII）をご覧ください。

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

スクリーナー質問のJSON

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

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にお問い合わせください。

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

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

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

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

連携設定をテストし、求人または連携を本番に出す前にすべてが円滑に動作することを確認するには、Apply XML configuration testing toolを使用します。

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

ツールがエラーを検出しない場合、テストを開始ボタンが表示されます。これを選択すると、求職者として応募プロセスをプレビューし、テスト応募を送信してプロセスが正しく動作することを確認できます。postUrlが有効であれば、応募データペイロード付きで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 エントリー Questionsツール

Indeed エントリー Questionsツール

JSONファイル全体をこのインタラクティブツールのメインフィールドに貼り付けると、フォーマットのエラーが強調表示されます。

エラーメッセージの例

エラーメッセージの例

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

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

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

VS Codeなどのより高度なコマンドについては、Command Paletteを選択するか、F1を押します。

より高度なコマンド

より高度なコマンド

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

JSONが正しくフォーマットされているように見えたら、テストを開始を選択して、スクリーナー質問が求職者にどのように表示されるかをプレビューします。

連携の状態を監視する

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

• 連携が求人応募を正常に配信すること。
• 質問ファイルが有効で、常に利用できること。

Indeedも、応募が代理店プラットフォームまたは第三者プラットフォームに正常に到達しているか、その他の連携状態の指標を監視します。問題が発生した場合、Indeedから連絡することがあります。場合によっては、問題を修正するまで、フィードの一部またはすべての求人でIndeed エントリー機能を無効にすることがあります。Indeedは未配信の応募を失いません。配信に失敗した場合、Indeedは元の応募送信後、定期的な間隔で自動的に再試行します。配信が引き続き不可能な場合、Indeedは応募を60日間保持します。Integrations Delivery Teamに連絡して、追加の再試行を依頼できます。

連携がスクリーナー質問をサポートしている場合は、それらのファイルをホストするページが常に利用でき、リダイレクトせず、正しくフォーマットされていることを確認してください。

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

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

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

応募者ステータスデータは、代理店プラットフォームまたは第三者プラットフォーム内の応募に対する更新に関する情報です。

更新とは、リクルーターのワークフローの変更、または候補者の応募後にリクルーターや候補者が行う操作です。たとえば、候補者が採用される場合です。

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

応募者ステータス連携APIガイドをご覧ください。

 

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