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

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

 

法的注意

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

概要

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

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

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

要件

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

• 貴社と Indeed の間で締結済みの Developer Agreement。すべての連携構築は、Indeed パートナーになる の正式な連携リクエストチャネルを通過する必要があります。
• 貴社のシステムと HTTP、XML、JSON を理解しているソフトウェア開発者。
• 作成した XML フィードを公開し、更新できる手段。FTP アクセスなど。
• 貴社のシステムから求人一覧のスクリーナー質問を HTTPS URL に公開する手段。
• Indeed エントリー API token。API token を生成する をご覧ください。

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

数百の連携パートナーでの実績に基づくと、このプロセスでは、設定、テスト、Indeed チームメンバーとのレビュー、クライアント導入に向けた展開に通常 6 週間かかります。

XML 連携では、定期的なスケジュールで XML フィードを設定し、Indeed に公開する必要があります。このフィードによって、クライアントの求人一覧の重要な詳細が Indeed 上でどのように表示されるかを制御できます。Indeed.com で Indeed エントリーを有効にするには、フィード内の各求人にメタデータを追加します。このメタデータにより、Indeed エントリーの応募フローでスクリーナー質問を表示し、候補者情報を貴社システムのどこに送るかを指定できます。Indeed エントリーのメタデータと任意のスクリーナー質問を含めて XML フィードを設定した後、Indeed は技術的な品質保証とポリシー遵守の観点からフィードをレビューします。

Indeed Integrations Delivery チームと連携し、フィードの公開および更新方法を選択し、Indeed のフィードバックと必要な修正内容を確認してください。

ロードマップ

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

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

API token を生成する

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

XML フィードを作成する

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

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

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 です。

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

• Indeed は、求人説明や応募プロセス内で不要な個人を特定できる情報（PII）を雇用主が求めることを許可していません。詳しくは、個人を特定できる情報（PII）に関するポリシーをご覧ください。

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

スクリーナー質問の JSON

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

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

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

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

応募配信

応募をプログラムで処理するには、Indeed エントリーが POST リクエストを送信する URL を指定します。<indeed-apply-postUrl> パラメーターは、Indeed が応募データを送信する 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 をご覧ください。

 

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