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

代理店および第三者プラットフォームが Indeed エントリーと連携するための設定手順です。

 

法的注意

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

概要

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

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

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

要件

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

• 貴社と Indeed の間で締結済みの Developer Agreement。すべての連携は、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 Apply を設定する
4. Indeed Apply のスクリーナー質問を追加する
5. Indeed から応募データを受信する
6. Indeed Apply の設定をテストする
7. 連携の状態を監視する
8. XML フィードをレビューに提出する
9. ディスポジションデータを Indeed に送信する

API トークンを生成する

Indeed パートナーになると、Indeed は連携用のアプリを作成します。アプリとその Indeed エントリー API トークン認証情報を確認するには、Partner Console にサインインしてください。

API トークン認証情報は client ID と secret です。この 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 feed reference をご覧ください。

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

求職者が Indeed 上で素早く応募できるようにするには、Indeed エントリーを通じて かんたん応募 機能を使用してください。

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

求人で Indeed エントリーを設定するには、次の手順を行います。

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

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

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

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

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

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

Indeed は、スクリーナー質問を貴社に代わってホストしません。貴社システムがスクリーナー質問をサポートする場合、連携を承認してもらうには Indeed エントリーで実装する必要があります。

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

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

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

  • Indeed エントリーの <indeed-apply-data> を含む XML フィード
  • 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）を雇用主が求めることを許可していません。詳しくは、Policy - Personally Identifiable Information (PII) をご覧ください。

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

スクリーナー質問の JSON

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

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

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

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

応募配信

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

postUrl の例

_indeed-apply-postUrl

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

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

パートナーは、POST 中に応募内容を検証しないでください。応募内容を検証して応募者を不合格にしたい場合は、POST の後続処理で実施してください。求職者データに対するパートナー側の検証が HTTP 失敗を引き起こすと、応募が送信された雇用主、またはフィード全体で Indeed エントリーが無効になる場合があります。

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

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

重複する応募

POST への応答において、応募を重複と見なすのは、過去 120 日以内の Indeed の応募と同じ求人 ID かつ同じ求職者メールアドレスを持つ場合だけです。

Indeed 以外のソースから送信された応募は、POST への応答時に重複判定に使用しないでください。同様に、同じ会社の別の求人 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 エントリーは、貴社の postUrl に POST リクエストを送信します。この HTTP ヘッダーによって、その POST が真正であることを検証できます。

Indeed は、Indeed エントリー認証情報タイプ用の共有 API シークレットを使用し、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 メタデータを生成させることもできます。ツールは書式と内容のエラーを特定するため、問題をすばやく見つけられます。

ツールがエラーを検出しない場合は、Start testing ボタンが表示されます。これを選択すると、求職者として応募プロセスをプレビューし、テスト応募を送信して、そのプロセスが正しく動作することを確認できます。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 Apply Questions tool

Indeed Apply Questions tool

このインタラクティブなツールのメインフィールドに JSON ファイル全体を貼り付けると、書式エラーをハイライトできます。

エラーメッセージの例

エラーメッセージの例

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

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

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

VS Code のような、より高度なコマンドを使用するには、Command Palette を選択するか F1 を押してください。

高度なコマンド

高度なコマンド

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

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

連携の状態を監視する

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

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

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

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

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

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

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

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

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

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

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

 

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