応募者ステータス連携API連携ガイド
求人応募の応募者ステータスデータをIndeedに送信するためにAPIと連携します。
このAPIとそのドキュメントを使用して連携を構築すると、APIに関する追加の利用規約およびガイドラインに同意したことになります。
連携の概要
応募者ステータス連携APIと連携して、Indeed エントリー求人とIndeed エントリー以外の求人の応募者ステータスデータをIndeedに送信します。
Indeedに応募者ステータスデータを送信するには、応募者ステータス連携APIと連携する必要があります。
連携手順
1. IndeedとDeveloper Agreementを締結する
IndeedとDeveloper Agreementを締結し、Indeedパートナーになるから連携リクエスト を送信します。
Indeedがアカウントを承認すると、アクセスが有効になり、連携に関するアンケートが送信されます。
2. 認証する
パートナーになると、IndeedはIndeed APIとサービスを製品に組み込むアプリを作成します。Partner Consoleで、アプリのOAuthクライアントIDとシークレットを取得します。
テスト用と本番用に別々のアプリを登録する必要はありません。レビューフェーズと本番フェーズの両方で、同じOAuthクライアントIDを使用します。
クライアントIDとシークレットをアクセストークンと交換し、応募者ステータス連携APIの呼び出しを認証します。トークンは1時間で有効期限が切れます。
3. ATSの応募者ステータスデータをIndeedに送信する
Indeed経由のすべての求人応募について、ATSの応募者ステータスデータをIndeedに送信します。
次のガイドラインに従ってください。
- ATSが応募を受信したら、
dispositionStatusをNEWに設定した応募者ステータスを少なくとも1件送信します。 - 各応募者ステータスを、最も近いIndeedの標準応募者ステータスにマッピングします。
- 応募に変更があったときは、即時または少なくとも1日に1回、更新を送信します。
- 各リクエストでは、応募者ステータスをステータス変更のタイムスタンプの古い順にソートします。
- 重複する応募者ステータスは許可されていますが、可能な限り避けます。
- 1件の応募に対する複数の一意のステータスは、1つのリクエストまたは複数のリクエストで送信します。
- 1つのリクエストで送信できる応募者ステータスは最大25件です。これを超える場合はリクエストを分割します。
- 実際の識別子（
indeedApplyID、ittk、universalApplyId、alternateIdentifier）を使用します。
連携のフェーズ
フェーズ1: レビュー
Indeedは、送信された応募者ステータスデータをサンドボックスデータベースに保存し、連携が正しく動作していることと応募者ステータスのマッピングが正確であることを確認するためにレビューします。
フェーズ2: 本番
Indeedは、送信された応募者ステータスデータを本番データベースに保存します。