Job Sync APIと連携する

Job Sync APIを連携するためのエンドツーエンドガイドです。

 

法的注意

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

Job Sync APIを使用して、IndeedとIndeed PLUSで求人を作成および管理します。

数百のパートナーとの連携実績から、この連携には通常約6週間かかります。この期間には、設定、テスト、Indeedとのレビュー、およびクライアント利用に向けたデプロイが含まれます。

採用担当者に関する注意事項

• jobRequisitionId はスキーマ上では任意ですが、jobPostingId と異なる場合、Indeed では必須です。

  日本の求人の場合: ID または jobPostingId と同じ値を設定します。

• SourcedJobPostingJobContactInput の hiring manager と recruiter の値は、スキーマ上では任意ですが、取得できる場合は Indeed で必須です。

関連項目:

• SourcedJobPostingMetadataInput の jobRequisitionId と jobPostingId
• SourcedJobPostingJobContactInput

連携ロードマップ

連携をIndeedにレビュー依頼する前に、次の手順を完了してください。

Job Sync API連携

#	手順
1.	連携の前提条件を満たす。
2.	求人のIndeed Applyを設定する。
3.	Indeed Applyのスクリーナー質問を追加する。
4.	Indeedから応募データを受信する。
5.	連携を実装する。
6.	連携を検証してテストする。
7.	連携を確認する。
8.	連携の正常性を監視する。
9.	応募者ステータスデータをIndeedに送信する。

1. 連携の前提条件を満たす

連携を開始する前に、次の手順を完了してください。

Job Sync API連携の前提条件

#	手順	備考
1.	クライアント名を収集してIndeedに送信します。	Indeedは既存のクライアント名の確認を支援します。 後で、それらの名称をSourcedJobPostingJobSourceInput.sourceNameで使用します。
2.	貴社とIndeedの間でDeveloper Agreementを締結し、Become an Indeed partnerから正式な連携リクエストを送信します。	Indeedがアカウントを承認すると、アクセスを有効にし、次の内容を確認するアンケートを送信します。 Indeed Applyとスクリーナー質問のレビュー計画。 本番公開の目標日。 ビジネス担当者とリード開発者またはエンジニアリングマネージャー。 想定される求人ボリューム。クライアント数と総求人数を含みます。 クライアントが雇用主か人材派遣会社か。 予定している連携パターン。
3.	各求人に公開求人詳細ページのURLを含めて送信します。	IndeedはこのURLをクロールして、送信された求人と一致することを確認します。省略すると、連携レビューが遅れることがあります。
4.	連携の問題が発生したときに、完全なリクエストとレスポンスをログに記録します。	トラブルシューティングのために、これらのログをIndeedに提供します。

Job Sync API連携は包括的である必要があります。クライアントごとに、公開されているすべての求人、またはクライアントの採用ページに表示されるすべての求人を送信してください。クライアントはオプトアウトできますが、その場合はそのクライアントのすべての求人を期限切れにし、送信を停止する必要があります。

クライアントの採用サイトで新規、更新、または期限切れの求人が公開されたら、変更をすぐに送信してください。Indeedが15分以内に更新を受信しない場合、求人の可視性が低下することがあります。既存求人を初めてAPI経由で送信するときは、100件未満のバッチで送信してください。

2. 求人のIndeed Applyを設定する

ATSをIndeedと連携すると、クライアントは求人掲載でかんたん応募を有効にし、応募者データをATSに送信できます。Indeed Applyは求職者体験を改善し、クライアントの採用を迅速化できます。

ソフトウェア内でIndeed Applyをエンドツーエンドでテストするには、サンドボックス求人の1件にIndeed Applyを追加してください。サンドボックス求人とは、Indeedが提供するサンドボックスソースに送信する求人です。その後、その求人を直接開いて応募します。テストにはスクリーナー質問も含めてください。

Indeed Applyを設定するには、次の手順を行います。

1. SourcedJobPostingIndeedApplyInputにIndeed Applyのフィールドを設定します。

   Indeedから応募データを受信するには、postUrlを、Indeedが応募データを送信するURLに設定します。

2. システムが応募データを解析して処理できることを確認します。

関連項目:

• Policy - Indeed Apply
• How to set up Indeed Apply

3. Indeed Applyのスクリーナー質問を追加する

スクリーナー質問は、雇用主が応募者が基準を満たしているかどうかをすばやく判断するのに役立ちます。雇用主がスクリーナー質問を使うと、適格な候補者とのやり取りにより多くの時間を使えます。Indeedはスクリーナー質問をホストしません。システムがスクリーナー質問をサポートしている場合は、Indeedが連携を承認するために実装が必要です。

Indeed Applyの応募フローでスクリーナー質問を表示するには、スクリーナー質問付きの求人を作成するをご覧ください。

4. Indeedから応募データを受信する

Indeedから応募データを受信するには、各求人にURLを指定します。IndeedはそのURLに、該当する求人の候補者情報をJSONとして送信します。

応募をプログラムで処理するには、次の手順を行います。

1. postUrlに設定したHTTPS URLで応募データを受信します。

   例:

   "postUrl": "https://www.example.com/jobs"

2. システムが正常に受信したすべての応募に対して、HTTP 2XXステータスコードを返します。Indeedは、それ以外のHTTPステータスコード、POSTタイムアウト、または接続タイムアウトをエラーとして扱います。

   Indeedが接続タイムアウト、POSTタイムアウト、または無効なHTTPレスポンスによりHTTP 2XXを受信しない場合、指数バックオフで応募を再試行します。最後の再試行後も失敗した場合、Indeedはその応募を最終失敗として扱います。

   POST中に応募内容を検証しないでください。内容を検証して応募者を不適格にする場合は、POSTの後で行ってください。パートナー側の検証エラーによって、Indeedが連携を無効にすることがあります。

   POSTリクエストを301や302などで別のURLにリダイレクトしないでください。Indeedはリダイレクトをサポートしていません。HTTPステータスコードをご覧ください。

重複する応募

応募を重複として扱うのは、次の両方に当てはまる場合だけです。

• 同じ求人IDを使用している。
• 過去120日以内のIndeedからの応募と同じ求職者メールアドレスを使用している。

Indeedからの応募が重複かどうかを判断するときに、別ソースから送信された応募を使用しないでください。同じ会社であっても、異なる求人IDで同じ求職者メールアドレスから送信された応募を重複として扱わないでください。

応募データ

Indeedは応募データをHTTP POSTリクエストの生のボディで送信するため、通常のフォーム送信のようには処理できません。リクエストボディにはJSONドキュメントが含まれており、読み込んで解析する必要があります。Indeedは毎回すべてのJSONフィールドを送信するわけではないため、欠落したフィールドを空として扱い、未知のフィールドを無視する堅牢なJSONパーサーを使用してください。

JSONペイロードに最大サイズはありません。

POSTボディはUTF-8でエンコードされており、Indeedが応募を送信したことを検証するための真正性ヘッダーが含まれます。

Applicantフィールドのファイル部分には、contentType、data、fileNameが含まれます。

• IndeedはcontentTypeをfileNameから判定します。
• dataには、Base64エンコードされた履歴書ファイルの生データが含まれます。
• サードパーティシステムは、.txt、.pdf、.doc、.docx、.rtfに対応する必要があります。

詳細は、応募データリファレンスをご覧ください。

POSTリクエストの認証

Indeed Applyは、リクエストが正当かどうかを確認するために使用できるHTTPヘッダーを含めて、postUrlにPOSTリクエストを送信します。

Indeedは、Indeed Applyの認証情報タイプに対応する共有APIシークレットを使用し、HMAC-SHA1アルゴリズムでメッセージシグネチャを計算します。そのシグネチャはHTTP X-Indeed-Signatureヘッダーで送信されます。

シグネチャの生成には、中括弧（{}）を含む完全で未変更のJSONペイロードと共有シークレットを使用します。

コード例については、メッセージシグネチャ生成リファレンスをご覧ください。

サポートされているSSL証明書

サポートされている証明書については、信頼済みルートSSL証明書をご覧ください。

証明書が一覧にない場合は、Integrations Delivery Teamに連絡してください。

関連項目:

• SourcedJobPostingIndeedApplyInput.postUrl
• HTTPステータスコード
• 応募の配信
• 重複する応募
• 応募データ
• POSTリクエストの認証
• サポートされているSSL証明書

5. 連携を実装する

連携を実装するには、次の手順を行います。

1. 本番環境を使わずにJob Sync APIをテストするには、シミュレートされたGraphQL環境を使用します。

2. IndeedがAPIアクセスを有効にすると、ソース名を割り当ててパートナーに共有します。すべてのテスト求人で、割り当てられたソース名だけをSourcedJobPostingJobSourceInput.sourceNameで使用してください。

   テスト求人で別の文字列を使用すると、Indeedはそれらの求人を検証できません。その場合、実際の求人を送信する前に、それらの求人を期限切れにする必要があります。

   テスト求人は実際の求人のように作成してください。たとえば、Fake test jobのようなタイトルは使用せず、実際の求人説明を含めてください。サンドボックスソースで送信した求人は求職者に表示されません。

   サンドボックス求人にIndeed Applyを追加すると、その求人を直接開いて応募することで、Indeed Applyをエンドツーエンドでテストできます。テストにはスクリーナー質問も含めてください。

3. テスト求人のエラーがなくなったら、サンドボックス求人を確認します。IndeedのEmployerページで、アプリ登録に使用したアカウントにサインインし、Jobsタブを選択します。

   Indeedがテスト求人を検証した後、既存のバッチ求人と本番の求人更新をレビュー用に送信できることを通知します。

4. 連携を検証してテストする前に、すべての非テスト求人で、その求人を所有する組織を識別するsourceNameを使用する必要があります。

   本番求人では、Indeedから提供された<sourceName>のテスト値を使用しないでください。

   テスト中に、Indeedチームから、貴社の求人に関連する組織のsourceName値一覧が共有されることがあります。本番求人を送信するときは、それらの組織の求人にその値を使用してください。そうしないと、クライアントがIndeed上で自社の求人を見つけられず、サポートリクエストが増えることがあります。

   詳しくは、求人掲載で雇用主をどのように区別すればよいですか？をご覧ください。

6. 連携を検証してテストする

連携を検証してテストするには、次の手順を行います。

1. 現在の求人一覧を送信したときに、一般的なGraphQLエラーコードが返されないことを確認します。

2. descriptionフィールド内のHTMLがHTMLエスケープされていないことを確認します。

3. 求人にすべての会社を含めます。

   Indeedにはすでに多くの求人一覧があるため、会社が欠けていると本番公開が遅れることがあります。

4. クライアントの採用サイトで公開されているすべての求人を含めます。

   親会社のサブブランドや子会社の求人も含めてください。採用サイトとAPIフィードで求人件数に差があると、連携経由の求人の可視性が低下することがあります。

   各求人のurlフィールドに一意のURLを設定してください。

5. 給与、勤務地、その他のメタデータが、採用サイト上の求人と一致していることを確認します。

6. 各求人のjobRequisitionIdが、採用サイト上のリクイジションIDと一致していることを確認します。

7. 複数の勤務地または言語がある求人を、固有の求人掲載に分割します。

   • 職位と勤務地の組み合わせごとに、1件の求人を掲載します。
   • 職位と言語の組み合わせごとに、1件の求人を掲載します。

   これらの固有の求人は、同じurlとjobRequisitionIdを使用できますが、重複を避けるために一意のjobPostingIdが必要です。

8. 利用できる場合は、採用責任者またはリクルーターのメールアドレスを提供します。

9. 開発中に作成したすべてのテスト求人を期限切れにします。

10. クライアントのウェブサイトに表示されるすべてのデータと一致するように、求人を更新し続けてください。

    多くのパートナーは、採用サイトに雇用形態、求人カテゴリ、完全な住所を含めています。

    IndeedはJob Sync APIフィードを本番公開する前に、APIデータと採用サイトを比較します。採用サイトと同じデータがAPIから送信されるまで、本番公開は遅れます。

    レビューの一環として、Indeedは貴社の連携を採用サイトと比較します。採用サイト上のすべてのデータを連携を通じて送信してください。

11. Indeedから共有されるIndeed Applyのチェックリストを完了します。

    HTTPエラーのシナリオをテストするには、チェックリストのHTTP codes / Security for post requestsの行を使用してください。

    スクリーナー質問の形式を検証し、postUrlを確認するには、Indeed Apply Integration Tools: Test Indeed Apply Questionsを使用してください。

7. 連携を確認する

連携がこれらの要件を満たしたら、次の内容が分かるスクリーンショット付きの資料を提出してください。

• 雇用主向け連携メニューにおけるIndeedのブランディングと配置
• 雇用主がIndeed Apply付き求人を送信する方法
• Indeed応募者のソーストラッキングを、雇用主向け求人分析でどのように表示するか
• 雇用主が求人のIndeed Applyを無効にする方法

Indeedが資料を受領し、連携をレビューして承認すると、メール通知が届きます。

8. 連携の正常性を監視する

Indeed Applyと連携する場合は、次の内容を確認する監視を設定してください。

• 求人応募が正常に配信されている。
• 質問ファイルが有効で、一貫して利用可能である。

Indeedも、ATSパートナーへの配信成功やその他の連携正常性指標を監視しています。問題が発生した場合、Indeedから連絡することがあります。場合によっては、問題を解決するまで、フィード内の一部またはすべての求人でIndeed Applyを無効にすることがあります。

Indeedは未配信の応募を失いません。配信に失敗した場合、元の送信後に一定間隔で自動的に再試行します。それでも配信できない場合、Indeedは応募を60日間保持します。追加の再試行はIntegrations Delivery Teamに依頼できます。

連携でスクリーナー質問をサポートしている場合は、それらのファイルをホストするページが引き続き利用可能で、リダイレクトせず、正しい形式を使用していることを確認してください。

9. 応募者ステータスデータをIndeedに送信する

応募者ステータスデータは、ATS内の応募に対する更新を表します。

更新には、リクルーターのワークフロー変更や、候補者の応募後にリクルーターまたは候補者が行う操作が含まれます。たとえば、候補者が採用される場合があります。

応募者ステータスデータをIndeedに送信すると、クライアントは時間の経過とともに、より質の高い応募を受け取れるようになります。

応募者ステータス連携APIガイドをご覧ください。

 

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