Employer Registration APIガイド

雇用主を登録して、ATSとIndeedの間で候補者データを同期し、機能設定を管理します。

 

法的注意

この API およびそのドキュメントを使用し、連携を構築することにより、お客様は追加 API 規約およびガイドラインに同意したものとみなされます。

Candidate Sync連携のために雇用主を登録するには、Employer Registration APIを呼び出します。これにより、雇用主はATSとIndeedの間で機能設定を管理し、候補者データを同期できるようになります。

Employer Registration APIのワークフロー

Employer Registration APIと連携した後、次の操作を呼び出せます。

1. 1.
   認証する。
2. 2.
   雇用主を登録する：雇用主を登録し、登録に関する情報を返します。
3. 3.
   登録を更新する：機能を有効化または無効化するために登録を更新します。
4. 4.
   登録を一覧表示する：雇用主の登録を一覧表示します。
5. 5.
   雇用主の登録を解除する：登録を削除し、その機能を無効化します。
6. 6.
   GraphQLエラーをトラブルシューティングする。

Employer Registration APIリファレンス

• registerEmployer：雇用主を登録し、登録に関する情報を返します。
• manageFeaturesForEmployer：機能を有効化または無効化するために登録を更新します。
• findRegisteredEmployers：ATS雇用主識別子で登録を一覧表示します。
• deregisterEmployer：登録を削除します。

認証する

When you become an Indeed partner, Indeed sets up an app for your integration. Sign in to Partner Console to view your app and OAuth credentials (client ID, secret, and authorization code for 3-legged OAuth). Exchange credentials for an access token to authenticate API calls.

Candidate Sync API の各オペレーションには OAuth トークンが必要です。

Candidate Sync API オペレーションの OAuth トークン種別

API とオペレーション	OAuth トークン種別
Employer Registration API 雇用主を登録する	雇用主を表す 3-legged OAuth トークン を使用し、employer.ats_candidate.sync スコープで認証します。このトークンは雇用主の Indeed アカウントと ATS アカウントを関連付けます。Indeed の管理者またはオーナーが作成する必要があります。registerEmployer がスコープ不足のエラーを返す場合、このトークンが雇用主に関連付けられていない可能性があります。
Employer Registration API 登録情報を更新する 登録情報を一覧表示する 雇用主の登録を解除する Send Candidates API 応募を初期化し、添付ファイルをアップロードする 応募を送信する 応募ステータスを追跡する 応募を削除する Retrieve Candidates API 未確認のアセットを取得する 時間範囲でアセットを取得する テストアセットを作成する	2-legged OAuth トークン. で認証します。アプリケーションは、ユーザー操作なしで Indeed の認可サーバーに直接認証します。

アクセストークンは ATS 内に安全に保存し、ユーザー間で共有しないでください。Indeed は、お客様のシステムが求人の信頼できる情報源であることを前提としています。あるユーザーが投稿した求人に別のユーザーのアクセストークンを使うと、Indeed 上でそのユーザーに別のユーザーの求人へのアクセスを付与する可能性があります。

アクセストークンを取得したら、クエリまたはミューテーションにこのトークンを含めます。最新の求人ステータスを確認するたびにユーザーへサインインを求めることがないよう、アクセストークンは有効期限が切れる前に更新することを推奨します。

Indeed と連携して API を呼び出す と スコープをご覧ください。

雇用主を登録する

リクエスト – Register employer

雇用主を登録し、登録情報を返すには、registerEmployer を呼び出します。

雇用主を表す 3-legged OAuth トークン を使用し、employer.ats_candidate.sync スコープで認証します。このトークンは雇用主の Indeed アカウントと ATS アカウントを関連付けます。Indeed の管理者またはオーナーが作成する必要があります。registerEmployer がスコープ不足のエラーを返す場合、このトークンが雇用主に関連付けられていない可能性があります。

RegisterEmployerInput では、次の入力フィールドを指定します。

registerEmployer の入力フィールド

フィールド	必須	説明
partnerEmployerId 型：ID!	✅	雇用主を一意に識別するために指定する ID です。 1 つの partnerEmployerId を複数の Indeed アカウントに登録できますが、各 Indeed アカウントでは、ATS ごとに 1 つの partnerEmployerId のみを使用できます。同じ Indeed アカウントで別の partnerEmployerId を使用すると、Indeed は登録を新しい atsName と partnerEmployerId に更新します。
atsName 型：String!	✅	雇用主に対して指定する名称です。Indeed 上では、この名称が雇用主に表示されます。

レスポンス – Register employer

API は EmployerRegistration を返します。後続の Candidate Sync API 呼び出しで使用するために id を保存するか、partnerEmployerId を指定して findRegisteredEmployers でもう一度取得します。

登録を更新する

リクエスト – 登録を更新する

雇用主の登録機能を有効化または無効化するには、manageFeaturesForEmployerを呼び出します。

2-legged OAuth トークン. で認証します。アプリケーションは、ユーザー操作なしで Indeed の認可サーバーに直接認証します。

次の入力フィールドを指定します。

manageFeaturesForEmployerの入力フィールド

フィールド	必須	説明
indeedRegistrationId タイプ：ID!	✅	ATSと雇用主の登録の一意のID。 この値には、registerEmployerが返すidを設定します。
features タイプ：EmployerRegistrationFeaturesInput!	✅	更新する機能。省略された機能と、現在のステータスと同じ値に更新された機能は変更されません。重複は許可されません。 次の機能をDISABLEDまたはENABLEDに設定します。 retrieveSourcedCandidatesClick： RetrieveSourcedCandidates.OneClick機能のステータス。 retrieveSourcedCandidatesAuto： RetrieveSourcedCandidates.AutomatedTransfers機能のステータス。 sendApplications： SendApplications機能のステータス。

レスポンス – 登録を更新する

レスポンスはEmployerRegistrationを返します。

登録を一覧表示する

リクエスト – 登録を一覧表示する

雇用主の登録を一覧表示し、manageFeaturesForEmployerやderegisterEmployerで使用する登録IDを取得するには、FindRegisteredEmployersを呼び出します。

2-legged OAuth トークン. で認証します。アプリケーションは、ユーザー操作なしで Indeed の認可サーバーに直接認証します。

次の入力フィールドを指定します。

FindRegisteredEmployersの入力フィールド

フィールド	必須	説明
partnerEmployerId タイプ：ID!	✅	雇用主を一意に識別する、パートナー提供のID。この値を使用して、雇用主の登録を一覧表示します。
indeedRegistrationId タイプ：ID	⬜	ATSと雇用主の登録ID。この値を使用して、特定の登録を表示します。 この値には、registerEmployerが返すidを設定します。

レスポンス – 登録を一覧表示する

フィルターに一致するEmployerRegistrationオブジェクトの配列を返します。

雇用主の登録を解除する

リクエスト – 雇用主の登録を解除する

登録を削除し、その機能を無効化するには、deregisterEmployerを呼び出します。

2-legged OAuth トークン. で認証します。アプリケーションは、ユーザー操作なしで Indeed の認可サーバーに直接認証します。

この登録を通じてIndeedに送信された雇用主または候補者のデータも削除されます。

次の入力フィールドを指定します。

deregisterEmployerの入力フィールド

フィールド	必須	説明
indeedRegistrationId タイプ：ID!	✅	ATSと雇用主の登録ID。 この値には、registerEmployerが返すidを設定します。

登録解除は永続的です。登録や保存された候補者データは復元できません。雇用主は再登録すると新しい登録IDを取得できます。

レスポンス – 雇用主の登録を解除する

DeregisterEmployerPartnerAtsSyncEmployerRegistrationPayloadオブジェクトを返します。

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

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

• GraphQLにアクセスする前に発生する可能性があるOAuthエラーは、OAuthエラーのトラブルシューティング。

• GraphQLエラーは、GraphQLエラーのトラブルシューティング。

• 求人投稿時に発生する問題は、求人がIndeedに表示されないのはなぜですか？。

 

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