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