代理店および第三者向けIndeed エントリー連携ガイド

クライアントが求人でIndeed エントリーを有効にし、応募を適切なプラットフォームに送信できるようにします。

 

法的注意

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

連携の概要

このガイドは、代理店および第三者プラットフォーム向けです。

貴社のプラットフォームをIndeed エントリーと連携すると、クライアントは求人でカンタン応募を有効にでき、Indeedは応募者を適切なプラットフォームに送信します。Indeed エントリーは求職者の応募を容易にし、クライアントがより早く採用できるよう支援します。

Indeed エントリーと連携するには、次のものが必要です。

• 貴社とIndeedの間で締結済みの開発者契約。1. Indeedと開発者契約を締結するをご覧ください。
• 貴社のシステムとHTTP、XML、JSONを理解している開発者。
• XMLフィードを公開および更新する手段。FTPなど。
• 審査用の質問をHTTPS URLで公開する手段。
• Indeed エントリーAPIトークン。2. 認証するをご覧ください。

連携では、設定、テスト、Indeedとのレビュー、展開まで通常6週間ほどかかります。

XML連携では、XMLフィードを定期的にIndeedに公開します。このフィードは、クライアントの求人がIndeed上でどのように表示されるかを制御します。Indeed エントリーを有効にするには、各求人にIndeed エントリーのメタデータを追加します。このメタデータは、応募に審査用の質問を追加し、候補者情報の送信先をIndeedに伝えます。

メタデータと任意の審査用の質問を追加した後、Indeedはそのフィードを技術品質とポリシー準拠の観点からレビューします。

Indeed Integrations Delivery （新しいウィンドウで開きます）チームと連携して、フィードの公開方法と更新方法を決め、フィードバックと必要な修正内容を確認してください。

---

連携手順

---

1. Indeedと開発者契約を締結する

Indeedと開発者契約を締結し、Indeedパートナーになる （新しいウィンドウで開きます）から連携リクエストを送信してください。

Indeedがアカウントを承認すると、Indeedはアクセス権を付与し、連携に関するアンケートを送付します。

---

2. 認証する

パートナーになると、Indeedは貴社の連携用のアプリを作成します。Partner Console （新しいウィンドウで開きます）で、アプリのIndeed エントリーAPIトークンを取得してください。認証情報をご覧ください。

このトークンは、Indeedに掲載する各求人に含めます。

---

3. XMLフィードを作成する

Indeed エントリーを設定するには、XMLフィードを作成して維持します。XMLフィードは、貴社の求人と、それらがIndeedでどのように表示されるかを定義するXMLドキュメントです。

クライアントが貴社システムで求人を作成すると、XMLフィードがそれらの求人をIndeedに送信します。

XMLフィードには次のものが含まれます。

XMLフィード

項目	定義
基本フィードノード	XMLバージョン、エンコーディング、貴社のプラットフォームの詳細など、フィードの一般情報です。
求人フィード要素	求人の詳細です。Indeedに表示する各求人について、これらの要素のセットを1つ含めます。

createSourcedJobPostings ミューテーションまたは XML フィードを通じて求人を作成した場合、その求人を期限切れにするには、お客様側で対応する必要があります。該当の求人は明示的に期限切れにする必要があります。

他のユーザーが updateSourcedJobPostings ミューテーションを呼び出した場合や、この求人の Indeed 求人詳細ページで Edit をクリックした場合でも、その求人は明示的に期限切れにする必要があります。

関連項目:

• createSourcedJobPostings
• updateSourcedJobPostings
• 求人詳細ページ（Indeed にサインイン済み）
• Job Sync XML フィードガイド

---

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

求職者がIndeedで迅速に応募できるようにするには、Indeed エントリーでカンタン応募を有効にします。

カンタン応募の求人はクリックが12%増加します。求職者はIndeedの履歴書で応募することもできます。

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

1. 1.
   XMLフィードの各求人について、<indeed-apply-data>要素にIndeed エントリーの設定パラメータを追加します。
2. 2.
   Indeedが応募を貴社システムに送信できるよう、<indeed-apply-postUrl>にpostUrlを設定します。
3. 3.
   貴社システムが応募データを解析できることを確認します。

---

5. Indeed エントリーの審査用の質問を追加する

審査用の質問により、採用企業は応募者が要件を満たしているかを確認できるため、選考にかける時間を減らし、候補者と向き合う時間を増やせます。

Indeedは審査用の質問をホストしません。貴社システムが審査用の質問に対応している場合は、Indeedが連携を承認する前に、Indeed エントリーに追加する必要があります。

Indeed エントリーに審査用の質問を追加するには、次のいずれかを行います。

• 質問をJSONとしてHTTPS URLでホストします。

  各<job>で、そのURLを<indeed-apply-data>内の<indeed-apply-questions>に指定します。

• 求人情報連携APIを呼び出して、審査用の質問付きで求人を作成します。

2024年1月以降、審査用の質問の設定にはスキーマバージョンがあります。Indeedは新機能を追加するとマイナーバージョンを上げます。応募ペイロードでは、バージョンが1.X（1.1や1.2など）として表示されます。連携が壊れないよう、この値をハードコードしないでください。審査用の質問のJSONは、マイナーなschemaVersionと一致している必要はありません。

留意点

• 質問は最大500件までです。

  20件を超えるとコンバージョンが大きく低下します。

• 質問ファイルは最大1 MBです。

• Indeedは一意のURLごとに質問ファイルをキャッシュします。キャッシュは24時間ごとに、またはキャッシュが1時間以上経過した時点で新しいリクエストが届いた場合はそれより早く更新されます。

• 採用企業は、求人の説明や応募で、不要な個人を特定できる情報（PII）を求めることはできません。詳しくは、Maintaining User Safety （新しいウィンドウで開きます）をご覧ください。

---

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

応募データを受信するには、フィード内の各求人にURLを指定します。Indeedは、その求人の候補者情報をこのURLにJSONとして送信します。

応募の配信

応募を自動的に処理するには、Indeed エントリーからのPOSTリクエストを受け付けるURLを使用します。このURLは<indeed-apply-postUrl>パラメータで設定します。URLではHTTPSを使用する必要があります。

postUrlの例

_indeed-apply-postUrl

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

Indeedは2XXステータスコードを受信しなかった場合、指数バックオフを使用して応募を再試行します。最後の自動再試行が失敗した場合、Indeedはその応募を失敗としてマークします。

POST中に応募内容を検証しないでください。応募内容を検証したり応募者を不適格にしたりする場合は、POSTを受け付けた後に行ってください。検証によってHTTPエラーが発生すると、Indeedはその企業またはフィード全体でIndeed エントリーを無効にすることがあります。

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

重複応募

POSTに応答する際は、同じ求人IDと同じ求職者メールアドレスを持つIndeedの応募が過去120日以内にある場合にのみ、応募を重複として扱ってください。

Indeed以外のソースからの応募は数えないでください。同じメールアドレスから同じ企業の別の求人IDへの応募は重複ではありません。

応募データ

Indeedは応募データをPOSTリクエストの生の本文にJSONドキュメントとして送信するため、システムは通常のフォームのように処理できません。JSONを読み取って解析してください。すべての応募にすべてのフィールドが含まれるわけではないため、欠落フィールドを空として扱い、未知のフィールドを無視するJSONパーサーを使用してください。

JSONペイロードに最大サイズはありません。

POST本文はUTF-8エンコーディングを使用します。リクエストには、Indeedが送信したことを検証できるヘッダーが含まれます。

Applicantフィールドのファイル部分には、contentType、data、fileNameが含まれます。

IndeedはfileNameからcontentTypeを決定します。

dataフィールドには、Base64でエンコードされた生の履歴書ファイルが含まれます。

貴社システムは、.txt、.pdf、.doc、.docx、.rtfのファイルタイプをサポートする必要があります。

候補者の履歴書の保存済みバージョンがすでにシステムにある場合は、代わりに応募JSON内のバージョンを保存して使用してください。

応募データの詳細については、応募データリファレンスをご覧ください。

POSTリクエストの認証

postUrlへの各POSTリクエストには、リクエストが真正であることを検証できるHTTPヘッダーが含まれます。

Indeedは、HMAC-SHA1アルゴリズムとIndeed エントリーの共有APIシークレットを使用してメッセージ署名を計算し、X-Indeed-Signatureヘッダーで送信します。

署名の対象は、中括弧（{}）を含む、変更していないJSONペイロード全体です。

コード例については、メッセージシグネチャ生成リファレンスをご覧ください。

サポートされるSSL証明書

サポートされる証明書については、信頼されたルートSSL証明書をご覧ください。

証明書がリストにない場合は、Integrations Delivery Team （新しいウィンドウで開きます）にお問い合わせください。

---

7. Indeed エントリーの設定をテストする

Indeed は、Indeed エントリー連携のコンポーネントをテストするツールを提供しています。これらのトピックを確認して、利用できるツールを把握し、連携の問題を早い段階で修正してください。

Indeed エントリーの応募フローと応募者配信をテストする

求人または連携を公開する前に連携をテストするには、Apply XML configuration testing tool （新しいウィンドウで開きます）を使用します。

求人のIndeed エントリーXMLメタデータを入力するか、選択したパラメータからツールにメタデータを生成させます。ツールはフォーマットと内容のエラーを検出します。

ツールがエラーを検出しない場合、Start testingが表示されます。これを選択すると、求職者として応募を進め、テスト応募を送信できます。postUrlが有効であれば、Indeedはテスト応募をそのURLに送信するため、システムがJSONを解析し、応募者情報を正しく表示することを確認できます。

Indeed エントリーのXMLメタデータをテストする

Indeed エントリー XML 設定テストツールの最初のタブでは、XML から Indeed エントリーのメタデータを入力し、応募フローで確認できます。Configuration セクションには、XML 内のすべてのパラメーターが一覧表示されるため、検出された求人要素を確認できます。

サポートされているパラメーターについては、Indeed エントリー設定リファレンスをご覧ください。

Indeed エントリー XML 設定テストツール - XML タブ

Indeed エントリー XML 設定テストツール - XML タブ

このツールは、必須パラメーターの不足やファイル形式の誤りなど、Indeed エントリーが正常に動作しなくなる可能性があるメタデータのエラーも検出します。いずれの場合も、ツールにアラートが表示されます。

例: パラメーター形式が正しくない場合のエラー

例: パラメーター形式が正しくない場合のエラー

例: パラメーターが不足している場合のエラー

例: パラメーターが不足している場合のエラー

2 つ目のタブでは、設定可能なパラメーターを入力すると、対応する Indeed エントリー XML メタデータが生成されます。応募フローで求人がどのように表示されるかをプレビューすることもできます。

ツールがメタデータを生成したら、それを XML フィードに追加します。例については、XML フィードを作成するをご覧ください。

Indeed エントリー XML 設定テストツール - 設定可能なパラメーター タブ

Indeed エントリー XML 設定テストツール

デフォルトのパラメーターに加えて、オプションの一覧から追加できます。選択して入力すると、ツールはそれらを生成される XML に追加します。

このツールを使用すると、Indeed エントリー連携をモックアップできます。Indeed エントリータグ内に postUrl を指定すると、応募体験を一通り確認し、ツールのサンプルデータを使用してその URL に応募を送信できます。

Indeed エントリーの審査用の質問をテストする

Indeed Apply Questions tool （新しいウィンドウで開きます） を使用して、審査用の質問 JSON の構文と、質問が Indeed エントリーのフローでどのように表示されるかを確認してください。

Indeed Apply Questions tool

Indeed Apply Questions tool

JSONファイルをツールのメインフィールドに貼り付けると、フォーマットのエラーが強調表示されます。

エラーメッセージの例

エラーメッセージの例

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

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

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

VS Codeなどのより高度なコマンドについては、Command Paletteを選択するか、F1を押します。

より高度なコマンド

より高度なコマンド

このツールにはこのドキュメントへのリンクもあるため、JSONパラメータを調べることができます。

JSONにエラーがなくなったら、Start testingを選択して、審査用の質問を求職者としてプレビューします。

---

8. 連携の状態を監視する

次のことを確認する監視を設定してください。

• 連携が求人応募を正常に配信すること。
• 質問ファイルが有効で、常に利用できること。

Indeedも、応募の配信とその他の連携状態の指標を監視します。問題が発生した場合、Indeedから連絡することがあります。場合によっては、問題を修正するまで、Indeedはフィードの一部またはすべての求人でIndeed エントリーを無効にします。Indeedは未配信の応募を失いません。配信に失敗した場合、Indeedは自動的に再試行します。それでも配信に失敗した場合、Indeedは応募を60日間保持します。追加の再試行を依頼するには、Integrations Delivery Team （新しいウィンドウで開きます）にお問い合わせください。

連携が審査用の質問に対応している場合は、質問ファイルをホストするページが常に利用でき、リダイレクトせず、正しくフォーマットされていることを確認してください。

---

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

開発が完了したら、技術担当の連絡先にXMLフィードを送ってレビューを受けるか、Partner Consoleでサポートをリクエストしてください。

---

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

応募者ステータスデータは、貴社プラットフォーム内の応募に対する更新を表します。

更新とは、リクルーターのワークフローの変更、または採用など、候補者の応募後にリクルーターや候補者が行う操作です。

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

応募者ステータス連携APIガイドをご覧ください。

---

関連項目

ガイド

• 応募データリファレンス — 応募JSONのPOST本文のフィールドリファレンスです。
• 応募配信リファレンス — POSTレスポンスで返すHTTPステータスコードです。
• 認証情報 — アプリは、OAuthのクライアントIDやシークレットなどの認証情報を使用して、一部のサービスと連携します。
• Increase candidate quality, hire more efficiently （新しいウィンドウで開きます） — Indeed エントリーを利用して、より関連性の高い候補者をより早く獲得する方法です。
• Indeed エントリー設定パラメーターの制限事項 — XMLフィードでIndeed エントリーを設定するときに従う制限事項です。
• Indeed エントリー設定リファレンス — XMLフィードでIndeed エントリーを設定するためのパラメーター、例、制限事項です。
• Indeed Apply Policy （新しいウィンドウで開きます）
• 求人情報連携APIガイド > 求人詳細ページ（Indeedにサインイン済み） — 求人詳細ページでの求人の検索可能ステータスの表示です。
• Job Sync XML フィードガイド — XMLフィードを使用して、求人とIndeedでの表示方法を定義します。
• 審査用の質問のJSONリファレンス — 審査用の質問をJSONで指定するためのパラメーターです。
• Maintaining User Safety （新しいウィンドウで開きます） — Indeedが求職者の安全を守り、個人情報を保護する方法です。
• メッセージシグネチャ生成リファレンス — メッセージシグネチャを生成するコードサンプルです。
• Indeed Apply Policy （新しいウィンドウで開きます） — Indeed エントリーを使用すると、Indeed上で求人に直接応募できます。
• 信頼されたルートSSL証明書 — Indeed エントリーが信頼するルートSSL証明書です。
• <indeed-apply-data>を含むXMLフィード — 1件の求人と<indeed-apply-data>要素を含むXMLフィードの例です。

GraphQL APIリファレンス

• createSourcedJobPostings — 求人をIndeedに送信します。
• updateSourcedJobPostings — ソース求人を更新します。このミューテーションを呼び出す前に、求人ソースをクレームしてください。

&nbsp;

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