Retrieve Candidates API連携ガイド
採用企業向けにIndeedから候補者情報を取得するためにAPIと連携します。
法的注意
この API およびそのドキュメントを使用し、連携を構築することにより、お客様は追加 API 規約およびガイドラインに同意したものとみなされます。
連携の概要
Retrieve Candidates APIと連携して、採用企業向けにIndeedから候補者情報を取得します。
連携手順
1. IndeedとDeveloper Agreementを締結する
IndeedとDeveloper Agreementを締結し、Indeedパートナーになる （新しいウィンドウで開きます）から連携リクエストを送信します。
Indeedがアカウントを承認すると、アクセスが有効になり、連携に関するアンケートが送信されます。
2. 認証する
Indeed パートナーになると、Indeed が連携用のアプリを作成します。Partner Console （新しいウィンドウで開きます） にサインインして、アプリと OAuth 認証情報（クライアント ID、シークレット、および 3-legged OAuth の認可コード）を確認します。これらの認証情報をアクセストークンと交換し、API 呼び出しを認証します。
2-legged OAuth トークン で認証します。アプリケーションは、ユーザー操作なしで Indeed の認可サーバーに直接認証します。
3. 連携を開発してテストする
-
採用企業が候補者と履歴書を取得し、候補者を確認済みにして、新しい候補者を受信できるATSのUIを構築します。
ATS候補者取得のモックアップ -
次の点を確認します。
- 候補者を取得するときに一般的なGraphQLエラーが発生しないこと。
- 候補者を取得できること。
- 候補者の履歴書をダウンロードできること。
- 候補者を確認済みにして、新しい候補者を受信できること。
4. 連携の承認を得る
連携のフロー全体を、ライブまたは録画した動画で実演します。
- 登録を作成します。
- ATSのUIに登録情報と無効化ボタンが表示されることを確認します。
- 登録を無効化して削除します。
- 2つ目の登録を作成します。
stageAssetsを使用して、2つ目の登録用のモックアセットを作成します。- モックアセットが5分以内にATSに表示され、ソースが正しいことを確認します（任意）。少なくとも、メールアドレス、氏名、履歴書が表示される必要があります。
- IndeedのUIから登録を無効化します。候補者はATSに残りますが、登録を示す表示は消えます。
Indeedは連携を承認した後、メールで通知します。
関連項目