応募者ステータス連携APIと連携する
求人応募の応募者ステータスデータをIndeedに送信するためにAPIと連携します。
このAPIとそのドキュメントを使用して連携を構築すると、APIに関する追加の利用規約およびガイドラインに同意したことになります。
応募者ステータス連携APIの概要
応募者ステータス連携APIを使用して、Indeed エントリー求人とIndeed エントリー以外の求人の応募者ステータスデータをIndeedに送信します。
Indeedに応募者ステータスデータを送信するには、応募者ステータス連携APIと連携する必要があります。
連携を始める前に
Indeedとの開発者契約を締結したパートナーのみが、Indeedと連携できます。このガイドは連携の計画に役立ちます。
応募者ステータス連携APIと連携するには:
| # | 手順 | 参照 |
|---|---|---|
| 1. | Indeedのパートナーになると、Indeedは製品にIndeed APIおよびサービスを組み込むアプリを設定します。Partner ConsoleでアプリのOAuth認証情報(クライアントIDとシークレット)にアクセスできます。 | |
| 2. | クライアントIDとシークレットをアクセストークンと交換し、応募者ステータス連携APIの呼び出し時の認証に使用します。トークンは1時間で有効期限が切れます。 | |
| 3. | Indeed経由のすべての応募について、IndeedはATSの応募者ステータスデータをIndeedに送信すること を必須としています。Indeedは少なくとも1件の応募者ステータスを、 | |
| 4. | 応募者ステータス連携APIで応募者ステータスデータをIndeedに送信する際は、各応募者ステータスを、最も適切に表すIndeedの標準応募者ステータスに設定してください。 | |
| 5. | 応募の応募者ステータスが遷移する際に、応募者ステータス連携APIでこれらのステータスを送信します。Indeedは、システムで変更が発生するたびに応募者ステータスデータを送信することを推奨します。または、スケジュールに基づいて送信することもできますが、少なくとも1日に1回は送信してください。 | Indeed エントリー求人の応募者ステータスデータを送信する |
| 6. | 応募者ステータスデータを送信する前に、1つのリクエストで送信するすべてのデータを、ステータス変更のタイムスタンプの昇順でソートします。 | |
| 7. | 応募について重複する応募者ステータスを送信することは可能です。ただし、可能な限り避けてください。 | |
| 8. | 応募について複数の一意の応募者ステータスを、1つまたは複数のAPIリクエストで送信します。 | |
| 9. | 可能な限り、複数の応募者ステータスを1つのAPIリクエストにまとめて送信してください。ただし、1つのリクエストで送信できる応募者ステータスは最大25件です。この上限を超える場合は、複数のリクエストに分割してください。 | |
| 10. | 応募者ステータス連携APIを呼び出す際は、 注: Indeed Tracking Token Key(ITTK)、ApplyID、および代替識別子は、日本では利用できません。 | PartnerDispositionIdentifierInput |
連携のフェーズ
応募者ステータス連携APIとの連携は、2つのフェーズで進行します。
| # | フェーズ | 説明 |
|---|---|---|
| 1 | レビュー | 応募者ステータス連携APIで応募者ステータスデータをIndeedに送信すると、Indeedはサンドボックスデータベースにデータを保存します。 Indeedはデータをレビューし、連携が正しく動作していることと、応募者ステータスのマッピングが正確であることを確認します。 |
| 2 | 本番 | 応募者ステータス連携APIで応募者ステータスデータをIndeedに送信すると、Indeedは本番データベースにデータを保存します。 |