直接連携の採用企業向けIndeed エントリー連携ガイド
直接連携の採用企業、およびその代理を行う第三者向けにIndeed エントリーと連携します。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
連携の概要
このページでは、直接連携の採用企業がIndeedと連携する方法を説明します。Indeed エントリーの有無にかかわらず、XMLフィードを送信する場合は、このガイドラインに従ってください。
XMLフィードによって、求人がIndeed上でどのように表示されるかが決まります。Indeed エントリーを追加すると、求職者がより簡単に応募できるようになり、より早く採用できます。
ご不明点がある場合は、Client Success担当者にお問い合わせください。担当者がいない場合は、このweb formをご利用ください。
Indeed エントリーと連携するには、次のものが必要です。
- 貴社とIndeedの間で締結された署名済みのDeveloper Agreement。1. IndeedとDeveloper Agreementを締結するをご覧ください。
- 貴社のシステムを把握し、HTTP、XML、JSONを理解しているソフトウェア開発者。
- XMLフィードを公開して更新する手段。たとえばFTPです。
- 審査用の質問をHTTPS URLに公開する手段。
- 単一リクエスター規則: 連携を構築する当事者のみが、APIキーまたはSFTP認証情報をリクエストして保持できます。Indeedは、採用企業が第三者インテグレーターのためにキーをリクエストする代理リクエストを許可していません。
全プロセスには、設定、テスト、Indeedとのレビュー、デプロイを含め、通常約6週間かかります。
XML連携では、一定のスケジュールでXMLフィードをIndeedに公開します。Indeed.comでIndeed エントリーを有効にするには、各求人にメタデータを追加します。このメタデータによって、応募フローに審査用の質問が表示され、Indeedに候補者情報の送信先が伝わります。
Indeed エントリーのメタデータと任意の審査用の質問を追加すると、Indeedはそのフィードを技術品質とポリシー準拠の観点でレビューします。
フィードの公開と更新の設定、およびIndeedからのフィードバックと必要な修正の確認については、Client Success担当者と連携してください。
連携手順
1. IndeedとDeveloper Agreementを締結する
IndeedとDeveloper Agreementを締結し、Become an Indeed partnerから連携リクエストを送信してください。
Indeedがアカウントを承認すると、アクセスを有効にし、連携に関するアンケートを送信します。
2. 認証する
日本のみ
- Manage app credentialsでIndeedアカウントにサインインし、Register new applicationを選択します。
- アプリ名と説明を入力し、認証情報タイプとしてIndeed Applyを選択して、Save and continueを選択します。
- Complete registrationを選択します。
Indeed エントリーのトークンを取得するには、Manage app credentialsに戻ります。クライアントIDをトークンとして使用します。
日本以外
Indeed エントリーのXML連携を構築するには、Indeed Client Success teamにお問い合わせください。Developer Agreementを締結すると、IndeedはIndeed APIとサービスを貴社製品に接続するアプリを作成します。
アプリとIndeed エントリーのAPIトークンを表示するには、Partner Consoleにサインインします。
- クライアントIDとクライアントシークレットをAPIトークンの認証情報として使用します。
- Indeedに投稿する各求人に、このAPIトークンを含めます。
3. XMLフィードを作成する
Indeed エントリーを設定するには、XMLフィードを作成して維持します。このXMLドキュメントは、求人と、それらがIndeed上でどのように表示されるかを定義します。
システムで求人を作成すると、XMLフィードがその求人をIndeedに送信します。
XMLフィードには次のものが含まれます。
- 基本フィードノード — XMLバージョンやエンコーディングなど、フィードの一般的な詳細を定義します。
- 求人フィード要素 — 求人固有の詳細を定義します。Indeedに表示する各求人について、これらの要素を1セット含めます。
createSourcedJobPostings ミューテーションまたは XML フィードを通じて求人を作成した場合、その求人を期限切れにするには、お客様側で対応する必要があります。該当の求人は明示的に期限切れにする必要があります。
他のユーザーが updateSourcedJobPostings ミューテーションを呼び出した場合や、この求人の Indeed 求人詳細ページで Edit をクリックした場合でも、その求人は明示的に期限切れにする必要があります。
関連項目:
4. 求人でIndeed エントリーを設定する
求職者がIndeedですばやく応募できるようにするには、Indeed エントリーでカンタン応募を有効にします。
カンタン応募が有効な求人は、クリック数が12%多くなります。求職者はIndeedの履歴書を使って応募することもできます。
求人でIndeed エントリーを設定するには:
- XMLフィード内の各求人について、
<indeed-apply-data>要素にIndeed エントリーの設定パラメ ータを追加します。 - システムがIndeedからの応募を受け取れるように、
<indeed-apply-postUrl>でpostUrlを設定します。 - システムが応募データを解析して処理できることを確認します。
関連情報:
5. Indeed エントリーの審査用の質問を追加する
審査用の質問を使うと、採用企業は応募者が基準を満たしているかどうかをすばやく判断できるため、候補者とのやり取りにより多くの時間を使えます。
Indeedは審査用の質問をホストしません。システムが審査用の質問をサポートしている場合は、Indeedが連携を承認するために、Indeed エントリーで実装する必要があります。
Indeed エントリーのフローで審査用の質問を表示するには、次を行います。
- 質問をJSON形式で記述します。
- HTTPS URLでホストします。
- そのURLを、
<indeed-apply-data>配下の<indeed-apply-questions>で各<job>に含めます。
スキーマバージョン
2024年1月に、Indeedは審査用の質問の設定にスキーマバージョンを追加しました。Indeedは機能を追加するたびにマイナーバージョンを更新します。応募ペイロードでは、バージョンが1.1や1.2のように1.Xとして表示されます。
メジャーまたはマイナーのアップグレードで連携が壊れないよう、この値は柔軟に扱ってください。審査用の質問のJSONは、マイナーのschemaVersionと一致させる必要はありません。
考慮事項
-
質問は最大500件まで設定できます。
質問が20件を超えると、コンバージョンが大きく低下します。
-
質問ファイルは1 MB未満にしてください。
-
一意の質問URLを使用してください。Indeedは質問ファイルをキャッシュし、24時間ごとに更新します。キャッシュが1時間を超えた後に新しいリクエストが届いた場合は、それより早く更新します。
-
質問URLのJSONを変更する場合や、履歴書の標準化を追加する場合は、キャッシュをクリアするために新しいURLに切り替えてください。
-
求人説明や応募プロセスで不要な個人を特定できる情報（PII）を要求しないでください。
-
求職者がIndeed エントリーを開始し、Indeedが質問をリクエストすると、Indeedはその質問をキャッシュします。
関連情報:
6. Indeedから応募データを受信する
Indeedから応募データを受信するには、フィード内で各求人にURLを指定します。IndeedはそのURLに、該当する求人の候補者情報をJSONとして送信します。
応募配信
応募をプログラムで処理するには、Indeed エントリーからのPOSTリクエストを受け付けるURLを指定します。
<indeed-apply-postUrl>パラメータがこのURLを定義します。このURLではHTTPSを使用する必要があります。
postUrlの例
indeed-apply-postUrl=https%3A%2F%2Fyourposturl.comシステムが正常に受信したすべての応募に対して、HTTP 2XXステータスコードを返します。Indeed エントリーは、それ以外のHTTPステータスコード、POSTタイムアウト、または接続タイムアウトを失敗として扱います。
例外として、JSONペイロードに必須のキーがない場合はHTTP 400を返してください。
タイムアウトまたは無効なレスポンスによりIndeedがHTTP 2XXを受信しない場合、指数バックオフで再試行します。最後の再試行後も配信できない場合、Indeedはその応募を最終失敗として扱います。
POST中に応募内容を検証しないでください。内容を検証して応募者を不適格にする必要がある場合は、POSTの後で行ってください。採用企業側の検証によって求職者データでHTTPの失敗が発生した場合、Indeedはその会社、またはフィード全体でIndeed エントリーを無効にすることがあります。
応募配信リファレンスをご覧ください。
POSTを301や302などのレスポンスで別のURLにリダイレクトしないでください。Indeed エントリーはリダイレクトをサポートしていません。
重複する応募
POSTに応答するときに応募を重複として扱うのは、次の両方に当てはまる場合だけです。
- 同じ求人IDを使用している。
- 過去120日以内のIndeedからの応募と同じ求職者メールアドレスを使用している。
POSTに応答するときに、別のソースから送信された応募を重複として扱わないでください。同じ採用企業で同じ求職者メールアドレスが 別の求人IDに応募した場合は、重複として扱わないでください。
応募データ
Indeedは応募データをHTTP POSTの生のボディで送信するため、一般的なフォームのようには処理できません。リクエストボディのJSONを読み込んで解析してください。Indeedは毎回すべてのJSONフィールドを送信するわけではないため、欠落したフィールドを空として扱い、認識できないフィールドを無視するパーサーを使用してください。
JSONペイロードに最大サイズはありません。
POSTボディはUTF-8でエンコードされており、Indeedが応募を送信したことを検証するのに役立つ真正性ヘッダーが含まれます。
Applicantフィールドのファイル部分には、contentType、data、fileNameが含まれます。
IndeedはcontentTypeをfileNameから判定します。
dataフィールドには、Base64エンコードされた履歴書ファイルの生データが含まれます。
システムは次のファイルタイプに対応する必要があります。.txt、.pdf、.doc、.docx、.rtf。
システムが履歴書のバージョンをすでに保存している場合でも、応募JSONから取得した更新版を保存して使用する必要があります。
応募データの詳細については、応募データリファレンスをご覧ください。
POSTリクエストの認証
Indeed エントリーは、そのPOSTが正当であることを検証するために使用できるHTTPヘッダーを含めて、postUrlにPOSTリクエストを送信します。
Indeedは、Indeed エントリーの認証情報タイプに対応する共有APIシークレットを使用し、HMAC-SHA1でメッセージ署名を計算します。Indeedはこの署名をX-Indeed-Signatureヘッダーで送信します。
署名の生成には、Indeed エントリーは中括弧（{}）を含む完全で未変更のJSONペイロードと共有シークレットを使用します。
Indeedがメッセージ署名を生成する方法のコード例については、メッセージシグネチャ生成リファレンスをご覧ください。
サポートされているSSL証明書
サポートされている証明書については、信頼されたルートSSL証明書をご覧ください。
証明書が一覧にない場合は、Client Success担当者にお問い合わせください。
7. Indeed エントリーの設定をテストする
Indeedは、Indeed エントリーの連携をテストするツールを提供しています。これらを使って、問題を早い段階で見つけてください。
Indeed エントリーの応募フローと応募者配信をテストする
求人または連携を公開する前に、Apply XML Configuration Testing Toolで設定をテストしてください。
ある求人のIndeed エントリーXMLメタデータを入力するか、設定可能なパラメータからツールに生成させます。このツールは書式と内容のエラーを指摘します。
エラーが検出されない場合は、Start testingが表示されます。Start testingを選択すると、応募体験を確認し、テスト応募を送信できます。postUrlが有効であれば、ツールはそのURLにテスト応募のペイロードを送信します。これを使って、システムがJSONを解析し、応募者情報が想定どおりに表示されることを確認してください。
Indeed エントリーのXMLメタデータをテストする
Indeed Apply XML Configuration Testing Toolの最初のタブでは、XMLからIndeed エントリーのメタデータを入力し、応募フローで確認できます。ConfigurationセクションにはXML内のすべてのパラメータが一覧表示されるため、検出された求人要素を確認できます。
Indeed エントリーのXML設定テストツール - XMLタブ
このツールは、必須パラメータの欠落や書式の問題など、Indeed エントリーの失敗につながるメタデータエラーも検出します。問題が見つかると、アラートを表示します。
例: パラメータの書式エラー
例: パラメータの欠落エラー
2番目のタブでは、設定可能なパラメータを入力すると、対応するIndeed エントリーXMLメタデータが生成されます。求人が応募フローにどのように表示されるかもプレビューできます。
ツールがメタデータを生成したら、XMLフィードに追加してください。
設定テストツール - 設定可能なパラメータタブ
オプション一覧からさらにパラメータを追加できます。選択して入力すると、ツールが生成したXMLに追加します。
このツールでは、Indeed エントリーの設定をモックアップできます。Indeed エントリーのタグでpostUrlを指定すると、応募フローを一通り確認し、そのURLに応募をPOSTできます。
Indeed エントリーの審査用の質問をテストする
Indeed Apply Questions toolを使って、審査用の質問のJSONの構文を確認し、質問が応募フローにどのように表示されるかを確認してください。
Indeed Apply Questions tool
JSONファイル全体をメインフィールドに貼り付けると、書式エラーを見つけられます。
エラーメッセージの例
エディター上で右クリックすると、基本的なテキストコマンドを実行できます。
基本的なテキストコマンド
VS Codeにあるようなより高度なコマンドを使うには、Command Paletteを開くか、F1を押してください。
より高度なコマンド
このツールにはこのドキュメントへのリンクが含まれているため、必要に応じてJSONパラメータを確認できます。
JSONの書式が正しくなったら、Start testingを選択して、審査用の質問が求職者にどのように表示されるかをプレビューしてください。
8. 連携の正常 性を監視する
Indeed エントリーと連携する場合は、次の内容を確認する監視を設定してください。
- 連携が求人応募を正常に配信している。
- 質問ファイルが有効で、常に利用可能である。
Indeedも、応募配信とその他の正常性指標を監視しています。問題が発生した場合、Indeedから連絡することがあります。場合によっては、問題を解決するまで、フィード内の一部またはすべての求人でIndeed エントリーを無効にすることがあります。
未配信の応募は失われません。配信に失敗した場合、Indeedは元の送信後に一定間隔で再試行します。それでも配信できない場合、Indeedは応募を60日間保持し、Client Success担当者を通じて依頼があれば再試行できます。
連携で審査用の質問をサポートしている場合は、それらのファイルをホストするページが引き続き利用可能で、リダイレクトせず、正しい形式を使用していることを確認してください。
9. XMLフィードをレビューに提出する
XMLフィードをClient Success担当者に提出する前に、遅延を避けるために次のチェックリストを完了してください。
提出 前チェックリスト
XMLファイル
| チェック項目 | 確認（はい/いいえ） |
|---|---|
XMLバージョンとエンコーディングを含む、すべての基本フィードノードを含めます。 | |
求人に関連するすべての会社を含めます。 | |
テスト求人は含めないでください。 | |
XMLファイル内のすべてのメタデータURLをURLエンコードします。 | |
| |
すべての求人に給与タグを含めます。 | |
外部IDが採用サイトのコンテンツと一致していることを確認します。 | |
クライアントを検証するため、すべての求人に |
Indeed エントリー - 審査用の質問
| チェック項目 | 詳細 | 確認（はい/いいえ） |
|---|---|---|
XMLの内容 | 各 | |
Indeed エントリーのパラメータ内のすべてのURLをURLエンコードします。 | ||
各求人に | ||
POSTリクエストのHTTPコードとセキュリティ | 応募が成功した場合はHTTP | |
重複する応募にはHTTP | ||
期限切れの求人への応募にはHTTP | ||
JSONペイロードに必須のキーがない場合はHTTP | ||
| ||
求人が存在しない場合はHTTP | ||
| ||
Indeed エントリーの | ||
アラートとログ記録 | 応募データを送信する
これらのログの例をスクリーンショットまたはテキストファイルで提供してください。 | |
審査用の質問のURLへの 審査用の質問のログには次を含めます。
これらのログの例をスクリーンショットまたはテキストファイルで提供してください。 | ||
求職者の応募データの配信 | 候補者の名と姓を | |
アップロードされたCVファイルを正しく取得して保存します。例をご覧ください。 | ||
IndeedのCVファイルを正しく取得して保存します。例をご覧ください。 | ||
応募ペイロードのサイズを制限しないでください。 | ||
審査用の質問 | ベストプラクティスに従って審査用の質問を作成します。 | |
応募に含まれるカバーレターやその他のドキュメントを取得して保存します。Applicantのフィールドをご覧ください。 | ||
審査用の質問で、完全な社会保障番号（SSN）などのPIIを求めないでください。 | ||
一般要件 | Indeed エントリーの応募を、sourceが「Indeed」に設定されたものとして識別します。 | |
analyticsフィールドを使って、応募をorganic、sponsored、Indeed Targeted Adに分類します。 | ||
SSL証明書が有効で最新であることを確認します。 |
10. 応募者ステータスデータをIndeedに送信する
応募者ステータスデータは、システム内の応募に対する更新を表します。
更新とは、候補者の応募後にワークフローで発生する変更のことです。たとえば、候補者を採用する場合です。
応募者ステータスデータをIndeedに送信すると、時間の経過とともに応募の質を改善できます。
応募者ステータス連携APIガイドをご覧ください。
関連情報
- Indeed エントリー設定リファレンス
- XML feed with <indeed-apply-data>
- Maintaining User Safetyと（日本語）Indeedでのユーザーの安全性確保