Disposition Sync APIガイド

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

 

法的注意

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

Disposition Sync APIと連携する

Integrate with the Disposition Sync APIを完了したら、次の項目を確認します。

1. 1.
   Disposition Sync API overview - Disposition Sync APIの仕組みを確認します。
2. 2.
   Authenticate.
3. 3.
   Send disposition data for Indeed Apply jobs.
4. 4.
   Troubleshoot errors - GraphQLエラーを解決します。

Disposition Sync API references

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

• Indeed standard disposition statuses.
• Disposition Sync API glossary.
• Disposition Sync API FAQs.

Disposition Sync APIの概要

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

Indeedに応募者ステータスデータを送信するには、Disposition Sync 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 – この識別子を設定すると、Disposition Sync APIは次の順序で最初の有効な識別子を使用します。 indeedJobKey – Indeedがパートナーに提供するjobKeyで求人を識別します。 employerJobId – Indeedがパートナーに提供する雇用主求人ID（EJID）で求人を識別します。 atsApplicationIdentifier – 会社名、requisition ID、必要に応じて応募IDで求人を識別します。 jobSeekerIdentifier – この識別子を設定すると、Disposition Sync APIは次の順序で最初の有効な識別子を使用します。 indeedJobSeekerKey – Indeed求職者キーです。 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を返し、Disposition Sync APIを通じてこのステータスを報告します。	Not_processed_Duplication duplicated_applications
8	DROPPED_FRAUD_SPAM	このステータスは、応募者ステータス自体ではなく、応募配信の失敗にのみ使用します。 応募が不正またはスパムとしてフラグされ、配信が非同期に失敗した場合、ATSはHTTP 200 OKを返し、Disposition Sync APIを通じてこのステータスを報告します。	Not_processed_fraud Not_processed_spam Not_processed_illegal_content
9	DROPPED_JOB_EXPIRED	このステータスは、応募者ステータス自体ではなく、応募配信の失敗にのみ使用します。 求人の期限が切れている、または求人が利用できず、配信が非同期に失敗した場合、ATSはHTTP 200 OKを返し、Disposition Sync APIを通じてこのステータスを報告します。	Not_processed_job_expired Job_Not_Available Job_Doesnt_exist
10	DROPPED_OTHER	このステータスは、応募者ステータス自体ではなく、応募配信の失敗にのみ使用します。 その他の理由で配信が非同期に失敗した場合、ATSはHTTP 200 OKを返し、Disposition Sync 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

Disposition Sync API用語集

Disposition Sync API glossary

Term	Description
ApplyID	求職者が採用サイトに遷移するURLごとに、Indeedは大文字と数字の文字列を追加します。ApplyIDは応募を一意に識別し、Indeedがその応募を追跡し、Disposition Sync 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が送客する求人応募を追跡します。
求人応募	求人への応募です。OAuth appについては、OAuth appをご覧ください。

Disposition Sync APIのよくある質問

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

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%です。

 

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