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 とシークレット）を確認できます。API 呼び出しを認証するには、これらの認証情報をアクセストークンと交換します。
2-legged OAuth トークン で認証します。アプリケーションは、ユーザー操作なしで Indeed の認可サーバーに直接認証します。
3. 連携を開発してテストする
#-
採用企業が候補者と履歴書を取得し、候補者を確認済みにして、新しい候補者を受信できるATSのUIを構築します。
ATS候補者取得のモックアップ -
次の点を確認します。
- 候補者を取得するときに一般的なGraphQLエラーが発生しないこと。
- 候補者を取得できること。
- 候補者の履歴書をダウンロード できること。
- 候補者を確認済みにして、新しい候補者を受信できること。
4. 連携の承認を得る
#連携のフロー全体を、ライブまたは録画した動画で実演します。
- 登録を作成します。
- ATSのUIに登録情報と無効化ボタンが表示されることを確認します。
- 登録を無効化して削除します。
- 2つ目の登録を作成します。
stageAssetsを使用して、2つ目の登録用のモックアセットを作成します。- モックアセットが5分以内にATSに表示され、ソースが正しいことを確認します（任意）。少なくとも、メールアドレス、氏名、履歴書が表示される必要があります。
- IndeedのUIから登録を無効化します。候補者はATSに残りますが、登録を示す表示は消えます。
Indeedは連携を承認した後、メールで通知します。
関連項目
#