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

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

 

法的注意

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

APIの概要

応募者ステータス連携APIは、ATSパートナーがIndeed エントリー求人とIndeed エントリー以外の求人の応募者ステータスデータをIndeedに送信するために使用するGraphQL APIです。応募者ステータスデータとは、候補者が応募した後にリクルーターや採用責任者が行うあらゆる更新であり、APIはすべての標準応募者ステータスに対応しています。

データはpartnerDisposition.sendミューテーションで送信し、各応募を送信時点から最終の応募者ステータスまで追跡できます。Indeedはこのデータを使用して候補者の求人検索体験を改善し、採用企業に採用活動に関する分析情報を提供します。

---

APIの手順

応募者ステータス連携APIと連携した後、次の手順を実行します。

---

1. 認証する

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

---

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

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

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

応募者ステータス連携APIの識別子

識別子	説明
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 – 会社名、リクイジションID、および任意の応募IDで求人を識別します。 jobSeekerIdentifier – APIは次の順序で最初の有効な識別子を使用します。 indeedJobSeekerKey – Indeed求職者キーです。 emailAddress – 求職者のメールアドレスです。

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を除くすべてのフィールドが必須です。

partnerDisposition.sendミューテーションは、SendPartnerDispositionPayload型を返します。この型には、次の内容が含まれます。

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

---

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

GraphQLに到達する前に発生するOAuthエラーについては、OAuthエラーのトラブルシューティングをご覧ください。

GraphQLエラーについては、GraphQLエラーのトラブルシューティングをご覧ください。

---

関連項目

リファレンス

• Indeedの標準応募者ステータス
• 日本のパートナー向けの要件
• 応募者ステータス連携API用語集
• 応募者ステータス連携APIのよくある質問

GraphQL APIリファレンス

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

 

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