ATS と Indeed Apply の連携

採用管理システム（ATS）パートナー向けの Indeed Apply 連携。

 

法的注意

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

概要

この連携手順は Indeed の採用管理システム（ATS）パートナー向けです。

• 貴社の ATS を Indeed と連携することで、クライアントは求人投稿で かんたん応募 を有効化し、応募者情報を ATS に配信できるようになります。Indeed Apply は求職者の体験を改善し、クライアントの適切な採用をより迅速に支援します。

• 貴社の ATS を Indeed Apply と連携する前に、Indeed との間で Developer Agreement を締結している必要があります。

要件

貴社の ATS を Indeed Apply と正しく連携するには、次のものが必要です。

• 貴社と Indeed との間の署名済みの Developer Agreement。すべての連携の構築は、Indeed パートナーになるの正式な連携リクエストチャネルを通じて、Indeed による審査と承認を受ける必要があります。
• 貴社のシステム、ならびに HTTP、XML、および JSON に精通したソフトウェア開発者。
• 構築した XML フィードを公開し、定期的に更新できる機能（FTP アクセスなど）。
• システムから求人に関連するスクリーナー質問を HTTPS URL に公開できる機能。
• Indeed Apply の API トークン。API トークンを生成するをご覧ください。

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

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

XML 連携では、定期的なスケジュールで XML フィードを Indeed に設定・公開する必要があります。これにより、クライアントの求人一覧の主要な詳細情報の Indeed 上での表示方法を制御できます。Indeed.com で Indeed Apply 機能を有効化するには、このフィード内の各求人にメタデータを付加します。これにより、Indeed Apply の応募フローでスクリーナー質問を表示でき、候補者情報の配信先を指定できます。Indeed Apply のメタデータと（任意の）スクリーナー質問を含めて XML フィードを最初に設定すると、Indeed は技術的な品質保証およびポリシー遵守の観点でフィードをレビューします。

フィードの公開・更新方法の指定、Indeed のレビュー結果や必要な修正内容の確認には、Indeed Integrations Delivery チームと連携してください。

ロードマップ

XML フィードを使用した連携の手順を次の順番で行います。

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

API トークンを生成する

Indeed パートナーになると、Indeed の API とサービスを貴社製品に組み込むためのアプリが Indeed 側でセットアップされます。アプリと Indeed Apply API トークンの認証情報を確認するには、Partner Console にログインしてください。API トークンの認証情報はクライアント ID とシークレットです。この API トークンは、Indeed に求人を投稿する際に各求人に対して指定する必要があります。

XML フィードを作成する

ATS で Indeed Apply を設定するには、XML フィードを作成・維持してください。XML フィードとは、求人内容と Indeed サイト上での表示方法を定義する XML ドキュメントです。

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

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

XML フィード

項目	定義する内容
基本的なフィードノード	XML バージョン、エンコーディング、ATS の情報など、XML フィードの一般的な情報。
求人フィード要素	求人固有の情報。Indeed に表示する求人ごとに、これらの要素を 1 セット含めます。

注記

createSourcedJobPostings ミューテーションまたはXMLジョブフィードを使用して求人を作成した場合、求人の有効期限切れには対応が必要です。該当の求人は明示的に有効期限切れにする必要があります。

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

関連項目：

• createSourcedJobPostings
• XMLジョブフィード
• updateSourcedJobPostings
• Indeed の求人詳細ページ

Job Sync XML フィードリファレンスをご覧ください。

求人で Indeed Apply を設定する

求職者が Indeed から素早く応募できるようにするには、Indeed Apply の かんたん応募 機能を使用します。

かんたん応募 機能が有効な求人は、クリック数が 12% 多くなります。Indeed Apply では、求職者が Indeed 履歴書を使用するオプションも利用でき、応募プロセスをさらに簡素化できます。

求人で Indeed Apply を設定するには、次の手順を行います。

1. XML フィードの求人に、Indeed Apply の設定パラメーターを <indeed-apply-data> 要素として追加します。
2. Indeed からの応募を受け取るため、<indeed-apply-postUrl> パラメーターで postUrl の値を設定します。
3. 必要に応じて、システム側で応募データを解析・処理できるようにします。

設定パラメーターについては、Indeed Apply の設定パラメーターをご覧ください。

<indeed-apply-data> 要素については、Indeed Apply の <indeed-apply-data> を含む XML フィード 要素の例をご覧ください。

かんたん応募 機能について詳しくは、Indeed Apply ポリシーおよび かんたん応募とは？をご覧ください。

Indeed Apply のスクリーナー質問を追加する

スクリーナー質問を使用すると、雇用主は応募者が基準を満たしているかどうかをすばやく判断できます。求人にスクリーナー質問を追加することで、雇用主は候補者の選別ではなく、候補者とのつながりに集中できます。

Indeed は、ユーザーに代わってスクリーナー質問をホストしません。システムでスクリーナー質問をサポートしている場合、連携の承認を得るには Indeed Apply 上で実装する必要があります。

Indeed Apply の応募フローでスクリーナー質問を表示するには、次のいずれかの方法を使用します。

• JSON 形式で記述し、HTTPS URL にホストして、その URL を各 <job> の <indeed-apply-data> 要素配下の <indeed-apply-questions> パラメーターに含めます。

  詳しくは次をご覧ください。

  • Indeed Apply の <indeed-apply-data> を含む XML フィード 要素の例
  • Indeed Apply 設定リファレンス

• Job Sync API を呼び出して、スクリーナー質問付きの求人投稿を作成します。

2024 年 1 月に、Indeed はスクリーナー質問設定にスキーマバージョンを導入しました。機能を追加するたびに、マイナーバージョンを更新します。スキーマバージョンは、応募ペイロード内で 1.X として表記されます（例：1.1、1.2）。連携を壊さずにメジャー／マイナーアップグレードに対応できるように、この値は柔軟に扱うことを推奨します。スクリーナー質問の JSON のマイナー schemaVersion を一致させる必要はありません。

考慮事項

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

  20 件を超えると応募完了率が急激に低下するというデータがあります。

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

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

• 履歴書の標準化サポートを実装し、質問 URL の内容（JSON データ）を変更する場合は、キャッシュをクリアするために新しい URL に変更してください。

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

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

スクリーナー質問の JSON

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

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

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

この URL では、その求人に対する候補者情報を JSON ドキュメントの形式で受信します。

応募の配信

応募をプログラムで処理するには、Indeed Apply が POST リクエストを送信する URL を指定します。<indeed-apply-postUrl> パラメーターは、Indeed が応募データを送信する URL を定義する文字列です。この URL は HTTPS である必要があります。

postUrl の例

indeed-apply-postUrl=https%3A%2F%2Fyourposturl.com

正常に受信したすべての応募について、システムが HTTP 2XX ステータスコードを返すようにしてください。Indeed Apply は、それ以外の HTTP ステータスコード、ポストタイムアウト、または接続タイムアウトはすべて失敗と見なします。

接続タイムアウト、ポストタイムアウト、または無効な HTTP レスポンスにより Indeed が HTTP 2XX ステータスコードを受信できない場合、Indeed は応募の再送信を試みます。Indeed は自動再送に指数バックオフを使用します。最後の自動再試行後も配信に失敗した場合、Indeed はその応募を最終的に失敗として扱います。

パートナーは、POST 中に求人応募の内容に対する検証を行わないでください。求人内容を検証して応募者を不合格にする場合は、POST の下流で行ってください。求職者データに対するパートナーの検証に起因する HTTP の失敗が発生した場合、応募が送信された会社、またはフィード全体で Indeed Apply が無効化される可能性があります。

応募配信リファレンスをご覧ください。

POST リクエストを 301 または 302 リダイレクトなどで別の URL にリダイレクトしないでください。Indeed Apply はリダイレクトに対応していません。

重複する応募

POST への応答時に、応募が重複と見なされるのは、過去 120 日以内の Indeed 経由の応募と同じ求人 ID で、かつ同じ求職者メールアドレスから送信された応募のみです。

Indeed 以外のソースから送信された応募は、POST への応答時に応募が重複かどうかの判定には使用しないでください。同様に、同じ求職者メールアドレスから同じ会社の別の求人 ID に送信された応募も、重複と見なさないでください。

応募データ

Indeed は応募データを HTTP POST リクエストの生のボディとして送信するため、リクエストを通常のフォームのように処理できません。リクエストのボディには、読み込んで解析する必要のある JSON ドキュメントが含まれています。すべての JSON フィールドが含まれているとは限らないため、欠落しているフィールドを空として扱い、認識できないフィールドを無視する堅牢な JSON パーサーを使用してください。

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

POST ボディは UTF-8 でエンコードされており、Indeed から送信された応募であることを検証するための真正性ヘッダーが含まれています。

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

contentType は fileName に基づいて判定されます。

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

第三者は次のファイル形式に対応する必要があります：.txt、.pdf、.doc、.docx、.rtf。

第三者がすでに自社システムに提供された履歴書の別バージョンを保存している場合でも、応募 JSON で提供される更新版を保存・使用する必要があります。

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

POST リクエストの認証

Indeed Apply は postUrl に POST リクエストを送信します。このリクエストには、POST の正当性を検証するための HTTP ヘッダーが含まれています。

Indeed は、Indeed Apply の認証情報タイプである共有 API シークレットを使用して、HMAC-SHA1 アルゴリズムでメッセージシグネチャを計算します。このシグネチャは HTTP の X-Indeed-Signature ヘッダーとして送信されます。

シグネチャを生成する際、Indeed Apply は中括弧（{}）を含む変更されていない JSON ペイロード全体と共有シークレットを使用します。

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

サポートされている SSL 証明書

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

ご使用の証明書が記載されていない場合は、Integrations Delivery チームにお問い合わせください。

Indeed Apply の設定をテストする

Indeedは、Indeed エントリーインテグレーションのコンポーネントをテストするためのツールを提供しています。

インテグレーションの問題を特定し、事前に修正するために、利用可能なテストツールとリソースについて以下のトピックを確認してください。

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

求人や連携を本番公開する前に連携セットアップをテストし、すべてが問題なく動作することを確認できるよう、Indeed では Apply XML 設定テストツールを提供しています。

このツールには、求人の Indeed Apply XML メタデータを入力するか、設定可能なパラメーターに基づいてツールが XML メタデータを生成することができます。ツールは書式や内容のエラーを特定するため、問題をすばやく特定できます。

エラーが検出されない場合、ツールに テスト開始 ボタンが表示されます。このボタンを選択すると、応募プロセスが求職者にどのように表示されるかを確認できます。また、テスト応募を送信して、プロセスが正しく動作することを確認できます。postUrl が有効であれば、応募データのペイロードと共に postUrl に送信されるテスト応募により、システムが JSON ドキュメントを正しく解析しているか、また応募者情報が想定どおりシステムに表示されるかを検証できます。

Indeed Apply の XML メタデータをテストする

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

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

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

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

また、このツールはIndeed エントリーの動作に影響を与える可能性のあるメタデータ内のエラーを自動的に検出します。たとえば、必須パラメーターが不足している場合やファイルのフォーマットが正しくない場合に、ツールがアラートを表示します。

例：パラメーターフォーマットエラー

例：パラメーターフォーマットエラー

例：パラメーター不足エラー

例：パラメーター不足エラー

エントリーXML設定テストツールの2番目のタブでは、さまざまな設定可能なパラメーターを入力し、Indeed エントリーに対応するXMLメタデータを自動的に生成できます。提供された情報で応募フローにおける求人の表示も確認できます。

生成後、メタデータをXMLフィードに追加できます。例については、XMLフィードを作成するをご覧ください。

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

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

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

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

Indeed Apply のスクリーナー質問をテストする

Indeed エントリー質問ツールを使用して、スクリーナー質問JSONファイルの構文を検証することもできます。このツールは、Indeed エントリーの応募フローでスクリーナー質問がどのように表示されるかを確認できます。

Indeed Apply Questions ツール

Indeed Apply Questions ツール

このインタラクティブツールのメインフィールドに JSON ファイル全体を貼り付けると、書式のエラーがハイライト表示されます。

エラーメッセージの例

エラーメッセージの例

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

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

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

VS Code にあるような高度なコマンドを使用するには、コマンドパレット を選択するか F1 キーを押してください。

高度なコマンド

高度なコマンド

このツールには本ドキュメントへのリンクも含まれており、関連する JSON パラメーターを必要に応じて参照できます。

JSON が正しく書式設定されていることを確認したら、テスト開始 を選択して、スクリーナー質問が求職者にどのように表示されるかをプレビューできます。

連携の状態を監視する

Indeed Apply と連携する際は、次の点を確実にするための監視を設定してください。

• 連携によって求人応募が正常に配信されている。
• 質問ファイルが有効で、常に利用可能である。

Indeed では、応募が代理店プラットフォームまたは第三者プラットフォーム（該当する場合）に正常に配信されているかどうか、およびその他の連携状態指標も監視しています。問題が発生した場合、Indeed からご連絡することがあります。場合によっては、問題が解決されるまで、フィードの一部またはすべての求人一覧で Indeed Apply 機能を Indeed が無効化することがあります。配信できなかった応募が失われることはありません。失敗した場合、最初の応募送信後、定期的な間隔で自動的に再試行が行われます。配信が不可能な場合は、応募は 60 日間保持され、Integrations Delivery チームにお問い合わせいただくと、リクエストに応じて再試行を行えます。

連携でスクリーナー質問をサポートしている場合は、それらのファイルをホストするページが常に利用可能で、リダイレクトせず、正しく書式設定されていることを確認してください。

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

開発が完了したら、レビューを受けるために XML フィードを技術担当窓口に提出するか、Partner Console からサポートをリクエストしてください。

ディスポジションデータを Indeed に送信する

ディスポジションデータとは、貴社の ATS 上での応募の更新に関する情報です。

更新には、リクルーターのワークフローの変更や、候補者の応募後にリクルーターまたは候補者が行うアクションが含まれます。たとえば、候補者が採用されることはディスポジションデータの一例です。

ディスポジションデータを Indeed に送信することで、クライアントは時間の経過とともに、より質の高い応募を受け取れるようになります。

Disposition Sync API ガイドをご覧ください。

 

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