応募者ステータス連携APIガイド

求人応募の応募者ステータスデータをIndeedに送信します。

 

法的注意

本APIの使用に関する Indeed との書面による同意がない限り、Indeed のAPIの使用に 追加API規約およびガイドラインが適用されることに同意したことになります。

応募者ステータス連携APIと連携する

応募者ステータス連携APIと連携するを完了したら、次の項目を確認します。

1. 1.
   応募者ステータス連携APIの概要 - 応募者ステータス連携APIの仕組みを確認します。
2. 2.
   認証する。
3. 3.
   Indeed エントリー求人の応募者ステータスデータを送信する。
4. 4.
   エラーをトラブルシューティングする - GraphQLエラーを解決します。

応募者ステータス連携APIのリファレンス

• partnerDisposition.send - Indeed エントリー求人の応募者ステータスデータを送信します。

• Indeedの標準応募者ステータス
• 応募者ステータス連携API用語集
• 応募者ステータス連携APIのよくある質問

応募者ステータス連携APIの概要

応募者ステータス連携APIを使用して、Indeed エントリー求人とIndeed エントリー以外の求人の応募者ステータスデータをIndeedに送信します。

Indeedに応募者ステータスデータを送信するには、応募者ステータス連携APIと連携します。

応募者ステータスデータは、partnerDisposition.sendミューテーションで送信します。

PartnerDispositionIdentifierInput入力オブジェクトには、次のいずれかの識別子を含めます。

Disposition Sync API identifiers

Identifier	Description
universalApplyId	Indeed Apply ID、Indeed Tracking Token Key（ITTK）、ApplyIDなどの標準形式で表した、求人応募の一意の識別子です。
indeedApplyID	Indeed エントリー求人向けにIndeedが割り当てる一意のIDです。候補者と求人を識別します。
ittk	Indeed Tracking Token Key（ITTK）です。求人応募を追跡します。
alternateIdentifier	応募者ステータスを送信する求人と求職者の代替識別子セットです。 jobIdentifier – この識別子を設定すると、応募者ステータス連携APIは次の順序で最初の有効な識別子を使用します。 indeedJobKey – Indeedがパートナーに提供するjobKeyで求人を識別します。 employerJobId – Indeedがパートナーに提供する雇用主求人ID（EJID）で求人を識別します。 atsApplicationIdentifier – 会社名、requisition ID、および必要に応じて応募IDで求人を識別します。 jobSeekerIdentifier – この識別子を設定すると、応募者ステータス連携APIは次の順序で最初の有効な識別子を使用します。 indeedJobSeekerKey – Indeed job seeker keyです。 emailAddress – 求職者のメールアドレスです。

認証する

Indeed パートナーになると、Indeed が連携用のアプリを作成します。Partner Console にサインインして、アプリと OAuth 認証情報（クライアント ID、クライアントシークレット、および 3-legged OAuth の場合は認可コード）を確認します。認証情報をアクセストークンと交換し、API 呼び出しを認証します。

Indeed エントリー求人の応募者ステータスデータを送信する

APIを呼び出すには、partnerDisposition名前空間のsendミューテーションを使用します。

mutation {
  partnerDisposition {
    send(input: {
      dispositions: [{
          dispositionStatus: HIRED,
          rawDispositionStatus: "Hired",
          rawDispositionDetails: "",
          identifiedBy: {
            indeedApplyID: "12345",
          },
          atsName: "MyATS",
          statusChangeDateTime: "2023-04-25T13:01:01.01Z",
        },
        {
          dispositionStatus: HIRED,
          rawDispositionStatus: "Hired",
          rawDispositionDetails: "",
          identifiedBy: {
            indeedApplyID: "12345",
          },
          atsName: "MyATS",
          statusChangeDateTime: "2023-04-25T13:01:01.01Z",
        }
      ],
    }) {
      numberGoodDispositions
      failedDispositions {
        identifiedBy {
          indeedApplyID
        }
        rationale
      }
    }
  }
}

SendPartnerDispositionInput入力オブジェクトでは、PartnerDispositionInputオブジェクトの配列を保持するdispositionsフィールドが必須です。rawDispositionDetailsを除き、PartnerDispositionInputのすべてのフィールドが必須です。

partnerDisposition.sendミューテーションは、SendPartnerDispositionPayload型を返します。

戻り値の型には、次の内容が含まれます。

• 成功した応募者ステータスの件数。
• 失敗した応募者ステータスの配列。各要素には、応募識別子と失敗理由が含まれます。

エラーをトラブルシューティングする

GraphQLにアクセスする前に発生する可能性があるOAuthエラーについては、Troubleshoot OAuth errorsをご覧ください。

GraphQLエラーについては、Troubleshoot GraphQL errorsをご覧ください。

Indeedの標準応募者ステータス

Indeedの標準応募者ステータス、つまり採用段階は次のとおりです。

Indeed standard disposition statuses

Indeed disposition status		Description	Example raw statuses from ATS
1	HIRED	Required. 候補者が求人オファーを受諾しました。	Hired Placed
2	NEW	Required. ATSが新しい求人応募を受け取りました。	New Applied Received New candidate
3	NOT_SELECTED	Required. 雇用主が候補者を選択しませんでした。	Rejected Release Unsuitable Do not pursue
4	ASSESS_QUALIFICATIONS	採用前の評価です。 スキルテスト、持ち帰り課題、その他の方法を含む場合があります。	Assessment Project Take home
4	BACKGROUND_CHECK	身元調査が進行中です。	References Background
6	CONTACTED	リクルーターが候補者に電話またはメールで連絡しました。 CONTACTEDには、不採用は含まれません。	Contacted Outreach
7	DROPPED_DUPLICATE	このステータスは、応募者ステータス自体ではなく、応募配信の失敗にのみ使用します。 重複した応募が存在し、配信が非同期に失敗した場合、ATSはHTTP 200 OKを返し、応募者ステータス連携APIを通じてこのステータスを報告します。	Not_processed_Duplication duplicated_applications
8	DROPPED_FRAUD_SPAM	このステータスは、応募者ステータス自体ではなく、応募配信の失敗にのみ使用します。 応募が不正またはスパムとしてフラグされ、配信が非同期に失敗した場合、ATSはHTTP 200 OKを返し、応募者ステータス連携APIを通じてこのステータスを報告します。	Not_processed_fraud Not_processed_spam Not_processed_illegal_content
9	DROPPED_JOB_EXPIRED	このステータスは、応募者ステータス自体ではなく、応募配信の失敗にのみ使用します。 求人の期限が切れている、または求人が利用できず、配信が非同期に失敗した場合、ATSはHTTP 200 OKを返し、応募者ステータス連携APIを通じてこのステータスを報告します。	Not_processed_job_expired Job_Not_Available Job_Doesnt_exist
10	DROPPED_OTHER	このステータスは、応募者ステータス自体ではなく、応募配信の失敗にのみ使用します。 その他の理由で配信が非同期に失敗した場合、ATSはHTTP 200 OKを返し、応募者ステータス連携APIを通じてこのステータスを報告します。	Not_Processed Dropped_error_detected Applications_Not_Ingested
11	INCOMPLETE	応募が未完了です。	Incomplete Unfinished
12	INTERVIEW	候補者が面接中です。 複数の面接にまたがる場合があります。	Interview First round interview Interview phase
13	JOB_CLOSED	雇用主が求人を終了しました。	Job close Job closure Job closed Job cancelled
14	JOB_INACTIVE	求人が非アクティブで、応募を受け付けなくなっています。	Job suspended Job inactive
15	LIKED	リクルーターが応募を高く評価した、お気に入りに追加した、またはショートリストに追加しました。	Liked Shortlist Highlight Favorited
16	OFFER_DECLINED	候補者がオファーを辞退しました。	Declined
17	OFFER_MADE	雇用主が候補者にオファーを出しました。	Offer Offering Offer initiated
18	ONBOARDED	雇用主が応募者の受け入れ手続きを完了しました。	Onboard First day at work
19	POSITIVELY_SCREENED	応募者が採用前スクリーニングに合格しました。 SCREENステータスにマッピングされます。	Passed first review
20	REVIEW	リクルーターが応募を確認しています。	In review Review Reviewing
21	SCREEN	採用前スクリーニングです。 電話スクリーニングやその他の方法を含む場合があります。	Phone screen
22	UNABLE_TO_MAP	他に該当するステータスがない場合にこのステータスを使用します。
23	VERIFY_ELIGIBILITY	採用前の適格性確認です。 免許確認、薬物検査、その他の方法を含む場合があります。	Drug screen License verification
24	WITHDRAWN	候補者が応募を取り下げました。	Candidate withdrew

応募者ステータス連携API用語集

Disposition Sync API glossary

Term	Description
ApplyID	求職者が採用サイトに移動する際、Indeedは各URLに大文字の英字と数字から成る文字列を追加します。ApplyIDは応募を一意に識別するため、Indeedは応募を追跡し、応募者ステータス連携APIを通じて応募者ステータスデータを受信できます。
ATS	Applicant tracking systemです。雇用主はATSを使用して次のことを行います。 募集中の求人に対する候補者を追跡する。 採用プロセス全体を管理する。
応募者ステータスデータ	ATS内の応募に対するあらゆる更新です。これには、候補者の応募後にリクルーターや採用責任者が実行する操作が含まれます。例: ATSが新しい応募を受け取る。 リクルーターが候補者に連絡する、面接する、オファーを出す、不採用にする、または採用する。
GraphQL	API向けのオープンソースのデータクエリおよび操作言語と、そのクエリ実行ランタイムエンジンです。GraphQLを使用すると、クライアントは宣言的なデータ取得によって、APIから必要なデータを正確に指定できます。 詳しくはGraphQLをご覧ください。
Indeed Apply ID	Indeed エントリー求人向けにIndeedが割り当てる一意のIDです。 候補者と求人を参照します。
ITTK	Indeed Tracking Token Key（ITTK）です。Indeedが送客する求人応募を追跡します。
job application	求人応募です。OAuth appについては、OAuth appをご覧ください。

応募者ステータス連携APIのよくある質問

ATSで雇用主がIndeedの候補者ステータスを変更すると、ATSは匿名化された応募IDと日時のタイムスタンプとともに、新しいステータスを送信します。

Indeedの求職者向けプロダクトチームは、グローバルなATSから収集した応募者ステータスデータを集計して分析します。このデータにより、求人広告のターゲティングと応募体験が向上するため、候補者は自分の履歴書のスキルが要件にどの程度一致しているかをより把握しやすくなります。

ATSで候補者を各段階へ進めることが重要である理由を、クライアントに伝えます。たとえば、CVを確認した後は、ステータスをreviewedまたはscreenedに変更します。

ステータスはATSによって異なります。Indeedは、雇用主の採用パイプライン内にいる各候補者について、可能な限り多くの更新を必要とします。

段階またはステータスの更新を継続的に送信するクライアントは、次のメリットを得られます。

• Indeedが今後より適切に候補者をマッチングすることに役立ちます。
• 十分な候補者がいる職種と不足している職種をすばやく把握できるため、より多くの候補者が必要な職種に注力と予算を移せます。
• 各段階に通常どの程度の時間がかかるかを把握できるため、採用までのタイムラインをよりよく理解できます。

Indeedは、NEW、INCOMPLETE、UNABLE_TO_MAP以外のあらゆるステータスを品質シグナルと見なします。階層型ステータスでは、ATSに少なくとも55%の品質シグナル採用率が必要です。

Indeedは、Indeed エントリー可能な求人のうち、Indeedに応募者ステータスシグナルを送信している割合によって、ATSの応募者ステータス採用率を測定します。すべてのクライアントがオプトインし、ATSがIndeedに受信確認を送信している場合、その割合は100%です。クライアントの50%だけがオプトインしていても、ATSがそれらすべての求人について応募者ステータスシグナルを送信していれば、その割合は100%のままです。

 

このページは役に立ちましたか？