- 概要
- 要件
- 開発とデプロイにかかる目安時間
- ロードマップ
- Indeed エントリー token を取得する
- 日本のみ
- 日本以外
- XML フィードを作成する
- 求人で Indeed エントリーを設定する
- Indeed エントリーのスクリーナー質問を追加する
- スキーマバージョン
- 考慮事項
- スクリーナー質問の JSON
- Indeed から応募データを受信する
- 応募配信
- 応募データ
- POST リクエストの認証
- サポートされている SSL 証明書
- Indeed エントリー設定をテストする
- Indeed エントリー応募フローと応募者配信をテストする
- Indeed エントリー XML メタデータをテストする
- Indeed エントリーのスクリーナー質問をテストする
- 連携の健全性を監視する
- XML フィードをレビューに提出する
- 提出前チェックリスト
- 応募者ステータスデータを Indeed に送信する
雇用主直接連携と Indeed エントリー
雇用主直接連携、およびその代理を行う第三者向けに Indeed エントリーと連携します。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
概要
このページでは、雇用主直接連携が Indeed とどのように連携するかを説明します。Indeed エントリーの有無にかかわらず、XML フィードを送信する場合は、このガイドラインに従ってください。
Indeed に XML フィードを送信すると、Indeed 上で求人がどのように表示されるかを制御できます。Indeed エントリーを追加すると、求職者はより簡単に応募できるようになり、求職者体験が向上し、より迅速に採用できます。
ご不明点がある場合は、Client Success 担当者にお問い合わせください。担当者がいない場合は、この web form を通じてお問い合わせください。
要件
Indeed エントリーと連携するには、次のものが必要です。
- 会社と Indeed の間の署名済み Developer Agreement。
- システムを把握しており、HTTP、XML、および JSON を理解しているソフトウェア開発者。
- XML フィードを公開および更新する手段。たとえば FTP アクセス。
- システムから求人のスクリーナー質問を HTTPS URL に公開する手段。
- Single Requester Rule: 実際に連携を構築している当事者のみが API key または SFTP 認証情報をリクエストして保持できます。Indeed は、雇用主が第三者インテグレーター向けに key をリクエストする proxy requests を許可していません。
開発とデプロイにかかる目安時間
数百の連携パートナーとの実績に基づくと、設定、テスト、Indeed とのレビュー、およびクライアント導入に向けたデプロイを含む全プロセスには通常約 6 週間かかります。
XML 連携では、一定のスケジュールで XML フィードを Indeed に公開します。このフィードにより、Indeed 上で求人がどのように表示されるかを制御できます。各求人にメタデータを追加すると、Indeed.com で Indeed エントリーを有効にできます。これにより、応募フローにスクリーナー質問が表示され、Indeed が候補者情報の送信先を把握できます。
Indeed エントリーのメタデータと任意のスクリーナー質問を含めてフィードを設定すると、Indeed はそのフィードを技術品質とポリシー準拠の観点でレビューします。
フィードの公開と更新の設定、および Indeed からのフィードバックと必要な修正の確認については、Client Success 担当者と連携してください。
ロードマップ
次の XML フィードベースの連携手順を完了してください。
- Indeed エントリー token を取得する
- XML フィードを作成する
- 求人で Indeed エントリーを設定する
- Indeed エントリーのスクリーナー質問を追加する
- Indeed から応募データを受信する
- Indeed エントリー設定をテストする
- 連携の健全性を監視する
- XML フィードをレビューに提出する
- 応募者ステータスデータを Indeed に送信する
Indeed エントリー token を取得する
日本のみ
- Manage app credentials ページで Indeed アカウントにサインインし、Register new application を選択します。
- アプリ名と説明を入力し、クレデンシャルタイプとして Indeed Apply を選択して、Save and continue を選択します。
- Complete registration を選択します。
Indeed Apply トークンを取得するには、Manage app credentials ページに戻ります。クライアント ID を Indeed Apply トークンとして使用します。
日本以外
Indeed Apply XML 連携を構築するには、Indeed Client Success team にお問い合わせください。Developer Agreement に署名すると、Indeed は Indeed API とサービスをお客様のプロダクトに連携するアプリをセットアップします。
アプリとその Indeed Apply API トークンクレデンシャルを表示するには、Partner Console にサインインします。
- クライアント ID とクライアントシークレットを API トークンクレデンシャルとして使用します。
- Indeed に投稿する各求人にこの API トークンを含めます。
XML フィードを作成する
Indeed エントリーを設定するには、XML feed を作成して維持してください。この XML ドキュメントは、求人と、それらが Indeed 上でどのように表示されるかを定義します。
システムで求人一覧を作成すると、XML フィードがそれらを Indeed に送信します。
XML フィードには次のものが含まれます。
- Basic feed nodes - XML バージョンやエンコーディングなど、フィードの一般的な詳細を定義します。
- Job feed elements - 求人固有の詳細を定義します。Indeed に表示したい各求人について、これらの要素を 1 セット含めます。
createSourcedJobPostings ミューテーションまたは XML job feed を通じて求人を作成した場合、その求人を期限切れにするには、お客様側で対応する必要があります。該当の求人は明示的に期限切れにする必要があります。
他のユーザーが updateSourcedJobPostings ミューテーションを呼び出した場合や、この求人の Indeed 求人詳細ページで Edit をクリックした場合でも、その求人は明示的に期限切れにする必要があります。
関連項目:
Job Sync XML feed reference をご覧ください。
求人で Indeed エントリーを設定する
求職者が Indeed ですばやく応募できるようにするには、Indeed エントリーを通じて かんたん応募 機能を有効にします。
かんたん応募 が有効な求人は、クリック数が 12% 多くなります。Indeed エントリーでは、求職者が Indeed Resume を使って応募できるため、プロセスがより簡単になります。
求人で Indeed エントリーを設定するには、次の手順に従ってください。
- XML フィード内の各求人に対して、
<indeed-apply-data>要素に Indeed エントリー設定パラメーターを追加します。 <indeed-apply-postUrl>パラメーターにpostUrl値を設定し、システムが Indeed からの応募を受け取れるようにします。- システムが受信した応募データを解析して処理できることを確認します。
設定パラメーターについては、Indeed エントリー設定リファレンスをご覧ください。
<indeed-apply-data> 要素については、Indeed エントリーの XML feed with <indeed-apply-data> 例をご覧ください。
かんたん応募 について詳しくは、Indeed Apply Policy および Indeed Apply: Build a pipeline of quality candidates fast をご覧ください。
Indeed エントリーのスクリーナー質問を追加する
スクリーナー質問を使用すると、雇用主は応募者が基準を満たしているかどうかをすばやく判断できます。これにより、雇用主は候補者とのやり取りにより多くの時間を使えます。
Indeed はスクリーナー質問をホストしません。システムがスクリーナー質問をサポートしている場合、Indeed が連携を承認するには、Indeed エントリーで実装する必要があります。
Indeed エントリーのフローにスクリーナー質問を表示するには、次を行ってください。
- 質問を JSON 形式で記述します。
- HTTPS URL にホストします。
<indeed-apply-data>配下の<indeed-apply-questions>パラメーターを使用して、その URL を各<job>要素に含めます。
XML feed with <indeed-apply-data> の例と、Indeed エントリー設定リファレンスをご覧ください。
スキーマバージョン
2024 年 1 月に、Indeed はスクリーナー質問設定に schema version を導入しました。Indeed は機能が追加されるたびに minor update を行います。応募 payload では、これらの version は 1.X として表示されます。たとえば 1.1 や 1.2 です。
major または minor のアップグレード中に連携が壊れないよう、この値は柔軟に扱ってください。スクリーナー質問 JSON の minor schemaVersion を一致させる必要はありません。
考慮事項
-
質問は 500 件以内にしてください。
データでは、20 件を超える質問を設定するとコンバージョンが大きく低下します。
-
質問ファイルは 1 MB 未満にしてください。
-
一意の質問 URL を使用してください。Indeed は質問ファイルをサーバーでキャッシュし、24 時間ごとに更新します。キャッシュが 1 時間を超えた後に新しいリクエストが到着した場合は、それより早く更新されます。
-
履歴書標準化サポートを追加し、Question URL の内容である JSON データを変更する場合は、キャッシュをクリアするために新しい URL に切り替えてください。
-
求人説明や応募プロセス中に不要な個人を特定できる情報（PII）を要求しないでください。詳しくは、Maintaining User Safety と (Japanese) Indeed でのユーザーの安全性確保 をご覧ください。
-
求職者が 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 応募と同じ求職者メールアドレスを使用している。
POST に応答する際、他のソースから送信された応募を重複として扱わないでください。同じ雇用主内の別の求人 ID に同じ求職者メールアドレスで応募した場合も、重複として扱わないでください。
応募データ
Indeed は応募データを HTTP POST リクエストの raw body として送信するため、一般的なフォームのようには処理できません。リクエスト body には、読み取りと解析が必要な JSON ドキュメントが含まれます。Indeed はすべての JSON フィールドを毎回送信するわけではないため、欠落フィールドを空として扱い、認識できないフィールドを無視する堅牢な JSON パーサーを使用してください。
JSON data 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 をご覧ください。
証明書が一覧にない場合は、Client Success 担当者にお問い合わせください。
Indeed エントリー設定をテストする
Indeed は、Indeed エントリー連携の各コンポーネントをテストするのに役立つツールを提供しています。
利用可能なテストツールとリソースを確認し、連携の問題を早い段階で特定するために、次のトピックをご覧ください。
Indeed エントリー応募フローと応募者配信をテストする
求人や連携を公開する前に連携設定をテストして、すべてが正しく動作することを確認するには、Apply XML Configuration Testing Tool を使用してください。
このツールには、ある求人の Indeed エントリー XML メタデータを入力することも、設定可能なパラメーターに基づいて XML メタデータを生成させることもできます。このツールは書式と内容のエラーを特定するため、問題をすばやく見つけられます。
エラーが検出されない場合、このツールには Start testing ボタンが表示されます。応募体験を確認してテスト応募を送信す るには、Start testing を選択してください。postUrl が有効であれば、このツールは応募データ payload を含むテスト応募を postUrl に送信します。そのテスト応募を使用して、システムが JSON ドキュメントを正しく解析し、応募者情報が想定どおりに表示されることを確認できます。
Indeed エントリー XML メタデータをテストする
Indeed エントリー XML Configuration Testing Tool の最初のタブでは、XML から Indeed エントリーメタデータを入力し、それを Indeed エントリー応募フローで確認できます。このタブの Configuration セクションには、XML に含まれるすべてのパラメーターも一覧表示されるため、検出された求人要素を確認できます。
サポートされているパラメーターについて詳しくは、Indeed エントリー設定リファレンスをご覧ください。
Indeed エントリー XML Configuration Testing Tool - XML tab
また、このツールは Indeed エントリーの失敗につながるメタデータエラーも自動的に検出します。たとえば、必須パラメーターの欠落や書式の問題を検出します。問題がある場合、このツールはアラートを表示します。
例: パラメーター書式エラー
例: パラメーター欠落エラー
Apply XML Configuration Testing Tool の 2 番目のタブでは、設定可能なパラメーターを入力し、対応する Indeed エントリー XML メタデータを自動的に生成できます。その情報で求人が応募フローにどのように表示されるかも確認できます。
このツールがメタデータを生成したら、それを既存の XML フィードに追加してください。例については、XML フィードを作成するをご覧ください。
Configuration testing tool - Configurable parameters tab
デフォルトパラメーターに加えて、オプション一覧からさらに多くのパラメーターを追加できます。選択して入力したパラメーターは、生成された XML に自動的に追加されます。
このツールでは、Indeed エントリー設定のモックアップを作成できます。Indeed エントリータグで postUrl を指定すると、応募フローを一通り確認し、サンプルデータ内の URL に応募を POST することもできます。
Indeed エントリーのスクリーナー質問をテストする
Indeed Apply Questions tool を使用して、スクリーナー質問 JSON ファイルの構文を検証することもできます。このツールでは、Indeed エントリー応募フローでスクリーナー質問がどのように表示されるかを確認できます。
Indeed Apply Questions tool
このインタラクティブツールの main field に JSON ファイル全体を貼り付けると、書式エラーを見つけられます。
エラーメッセージの例
エディター上で右クリックすると、基本的なテキストコマンドを実行できます。
基本的なテキストコマンド
VS Code にあるようなより高度なコマンドを使用するには、Command Palette を開くか F1 を押してください。
より高度なコマンド
このツールには、このドキュメントへのリンクも含まれているため、必要に応じて関連する JSON パラメーターを確認できます。
JSON の書式が正しいことを確認したら、Start testing を選択して、スクリーナー質問が求職者にどのように表示されるかをプレビューしてください。
連携の健全性を監視する
Indeed エントリーと連携する場合は、次の点を確認するための監視を設定し てください。
- 連携が求人応募を正常に配信している。
- 質問ファイルが有効で、常に利用可能である。
Indeed は、連携が応募を正常に配信しているかどうか、およびその他の連携健全性指標も監視しています。問題が発生した場合、Indeed から連絡することがあります。場合によっては、問題を修正するまで、Indeed はフィード内の一部またはすべての求人について Indeed エントリーを無効にすることがあります。
配信されなかった応募は失われません。配信に失敗した場合、Indeed は元の送信後、一定間隔で自動的に再試行します。それでも配信できない場合、Indeed は応募を 60 日間保持し、Client Success 担当者を通じて依頼があれば再試行できます。
連携がスクリーナー質問をサポートしている場合は、それらのファイルをホストしているページが利用可能であり、リダイレクトせず、正しい形式を使用していることを確認してください。
XML フィードをレビューに提出する
XML フィードを Client Success 担当者に提出する前に、遅延を避けるために次のチェックリストを完了してください。
提出前チェックリスト
XML ファイル
| チェック項目 | 確認（はい/いいえ） |
|---|---|
XML version と encoding を含むすべての基本フィードノードが XML ファイルに含まれていることを確認してください。 | |
採用サイト上の各求人について、XML ファイルに | |
求人に関連するすべての会社が XML ファイルに含まれていることを確認してください。 | |
XML ファイルにテスト求人が含まれていないことを確認してください。 | |
XML ファイル内のすべてのメタデータ URL が URL エンコードされていることを確認してください。これらの URL 要素には | |
XML ファイル内のどこにも、 | |
すべての求人に salary tags が含まれていることを確認してください。 | |
external ID が採用サイトのコンテンツと一致していることを確認してください。 | |
クライアント検証のため、すべての求人に |
Indeed エントリー - スクリーナー質問
| チェック項目 | 詳細 | 確認（はい/いいえ） |
|---|---|---|
XML content | 各求人の | |
Indeed エントリーパラメーター内のすべての URL が URL エンコードされていることを確認してください。これらの URL 要素には | ||
各求人に | ||
HTTP codes / Security for post requests | 応募成功時に HTTP | |
重複応募には HTTP | ||
期限切れ求人への応募には HTTP | ||
JSON payload 構造に必須 key がない場合は HTTP | ||
| ||
無効な求人、つまり求人が存在しない場合は HTTP | ||
payload が大きすぎる場合は HTTP | ||
必須のスクリーナー質問回答がない場合は HTTP | ||
| ||
Indeed エントリーの | ||
Alerts and logging | 求職者の応募データを送信する
これらのログの例をスクリーンショットまたはテキストファイルで提供してください。 | |
スクリーナー質問 URL に対する スクリーナー質問ログには次を含めてください。
これらのログの例をスクリーンショットまたはテキストファイルで提供してください。 | ||
求職者応募データの配信 | プラットフォームが JSON の | |
アップロードされた CV ファイルをプラットフォームが正しく取得して保存していることを確認してください。例をご覧ください。 | ||
Indeed Resume の CV ファイルをプラットフォームが正しく取得して保存していることを確認してください。例をご覧ください。 | ||
システムに応募 payload のサイズ制限がないことを確認してください。 | ||
スクリーナー質問 | スクリーナー質問が best practices に従って作成されていることを確認してください。 | |
応募に含まれる追加のカバーレターやその他のドキュメントをプラットフォームが取得して保存していることを確認してください。Applicant fields をご覧ください。 | ||
PII 制限については、Maintaining User Safety（Japanese: Indeed でのユーザーの安全性確保）をご覧ください。完全な Social Security number（SSN）などの PII をスクリーナー質問で求めないでください。 | ||
一般要件 | プラットフォームが Indeed エントリーからの求職者応募を、source が “Indeed” に設定されたものとして識別していることを確認してください。 | |
analytics フィールドで、応募を organic、sponsored、または Indeed Targeted Ad に分類できることを確認してください。 | ||
SSL 証明書が有効であり、最新であることを確認してください。 |
応募者ステータスデータを Indeed に送信する
応募者ステータスデータ は、システム内の応募に対する更新を表します。
更新とは、ワークフローの変更や、候補者の応募後に行うアクションです。たとえば候補者の採用です。
応募者ステータスデータを Indeed に送信すると、時間とともに応募の質を改善できます。
Disposition Sync API Guide をご覧ください。