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：登録を削除します。

認証する

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

Candidate Sync APIの各操作には、OAuthトークンが必要です。

Candidate Sync API操作のOAuthトークンタイプ

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

アクセストークンはATSに安全に保管し、ユーザー間で共有しないでください。Indeedは、お客様のシステムが求人の信頼できる情報源（source of truth）であると想定しています。あるユーザーが投稿した求人に対して別のユーザーのアクセストークンを使用すると、Indeed上で他のユーザーの求人へのアクセス権がそのユーザーに付与される可能性があります。

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

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

雇用主を登録する

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

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

認証

employer.ats_candidate.syncスコープを持つ、雇用主を表す3-legged OAuthトークンで認証します。このトークンは、雇用主のIndeedアカウントとそのATSアカウントを関連付けます。Indeedの管理者またはオーナーが作成する必要があります。

registerEmployerがスコープ不足のエラーを返す場合、トークンが雇用主に関連付けられていない可能性があります。

雇用主を表す3-legged OAuthトークンをご覧ください。

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

registerEmployerの入力フィールド

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

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

レスポンスはEmployerRegistrationを返します。以降のCandidate Sync APIの呼び出しで使用するため、登録のidを保存してください。後からpartnerEmployerIdを使ってfindRegisteredEmployersで検索することもできます。

登録を更新する

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

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

認証

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

2-legged OAuthトークンをご覧ください。

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

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の認可サーバーと直接認証します。

2-legged OAuthトークンをご覧ください。

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

FindRegisteredEmployersの入力フィールド

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

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

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

雇用主の登録を解除する

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

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

認証

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

2-legged OAuthトークンをご覧ください。

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

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

deregisterEmployerの入力フィールド

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

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

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

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

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

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

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

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

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

 

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