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