よくある質問
Indeed API との連携に関するよくある質問への回答を確認します。OAuth認証情報はクライアントIDとシークレットです。パートナーコンソールでこれらの認証情報にアクセスします。クライアントIDとシークレットをアクセストークン(長い暗号化された文字列)と交換します。すべてのAPI呼び出しにこのトークンを含めて、アプリのIDと権限を認証します。アクセストークンの有効期限は1時間です。
認可コードフロー(3レグOAuth)が必要な連携を構築しているATSで、IndeedにOAuthアプリケーションを登録していない場合は、OAuthクライアントIDを作成する必要があります。
Indeedパートナーになると、IndeedはIndeedのAPIとサービスを製品に統合するアプリをセットアップします。IndeedはIndeedユーザーアカウントにパートナーコンソールへのアクセスを付与し、アプリのOAuth認証情報(クライアントIDとシークレット)にアクセスするために使用します。
これらのOAuth認証情報をアクセストークンと交換するために必要です。その後、Indeed API呼び出しにアクセストークンを含めて、アプリのIDと権限を認証します。
アクセストークンの有効期限は1時間のため、1時間ごとにOAuth認証情報をアクセストークンと交換します。
認可コードフロー(3レグOAuth)では、アプリは認可コードをリクエストする必要があります。認可コードは、ユーザーとその関連雇用主アカウントに代わってアプリが操作する権限を付与します。たとえば、このフローを使用してIndeed面接を作成したり、スポンサー付きキャンペーンを作成したりします。
アクセスしたいアカウントのユーザーがこのコードを付与します。コードの有効期限は10分です。認可コードを取得したら、Indeedユーザーアカウントでパートナーコンソールにログインします。
ダッシュボードで、アプリリストからアプリを選択します。アプリ詳細ページの認証情報タブには、OAuth認証情報(クライアントID、シークレット、認可コード)が表示されます。これらの認証情報をアクセストークンと交換します。
When you request an access token, you receive a response like this:
{ "access_token": "<access_token>", "refresh_token": "<refresh_token>", "id_token": "<id_token>", "scope": "offline_access employer_access email", "consented_scope": "offline_access employer_access email", "convid": "1er835qvtu54n800", "token_type": "Bearer", "expires_in": 3600}JWTデバッガーにアクセスします。
Indeed redirects the user to the page at the redirect_uri endpoint with the code and state parameters appended. For example:
http://www.companyname.com/oauth/indeed?code=rXZSABCyYQHQ&state=employer12https://apis.indeed.com/oauth/v2/tokensエンドポイントにPOSTリクエストを送信します。
code、client_id、client_secret、redirect_uri、grant_typeパラメータを指定する必要があります。オプションでemployerパラメータを指定できます。
See Get access token that represents an employer.
This authorization link triggers the display of these screens:
| Screen | Description |
|---|---|
| Authentication | Appears when the user is logged out of Indeed. |
| OAuth consent | Enables a user to grant consent for any scopes that the OAuth app requests, such as the employer_access scope. |
| Indeed employer selection | Enables a user to select an employer from a list of employers associated with the user account. |
ユーザーアカウントに雇用主が関連付けられている場合は、認可コードをリクエストする際にprompt=select_employerを指定する必要があります。このパラメータにより、認可するユーザーにIndeed雇用主選択画面が表示され、ユーザーが雇用主アカウントを選択できます。
アクセストークンは1つの雇用主のみを表します。雇用主を切り替えるには、アクセストークンを取得してください。
すべてのIndeed エントリー連携には、スクリーナー質問、人口統計データ取得を含む更新されたスキーマによる均等雇用機会(EEO)質問(米国雇用主をサポートする場合)、および応募者ステータス連携機能が必要です。
この短い動画では、新機能と組織が取るべきアクションを要約しています。Indeed エントリー機能強化プレゼンテーションのコピーにアクセスできます。
Indeedは、データループを完結させ、採用プロセスにおける応募者の進捗を正確に追跡するために、応募者ステータス連携を要求しています。この機能は、マッチングアルゴリズムの改善とクライアントのパフォーマンスの最適化に不可欠です。応募者ステータス連携は 、スクリーナー質問およびEEOコンプライアンス(該当する場合)とともに、すべてのIndeed エントリー連携の必須コンポーネントです。
Indeedは、進化する法律や規制に対応して義務を継続的に評価・調整しています。法的要件の変更に伴い、Indeedはコンプライアンスに引き続き取り組み、適用されるデータ保護およびプライバシー法との整合性を確保するためにポリシーと慣行を更新します。
Indeedは、GDPRおよびその他の関連プライバシー法を完全に遵守しています。応募者ステータス連携データの返却は、求人マッチングと採用成果の改善にのみ使用されるため、法的およびコンプライアンス義務に沿っています。すべてのデータ処理は、プライバシーポリシーおよび適用される規制に従って行われます。IndeedのGDPRコンプライアンスの詳細については、Indeed GDPRコンプライアンスをご覧ください。
現在、雇用主固有のデータはクライアント固有のマッチングを改善するものではありませんが、応募者ステータスデータは、雇用主がどの候補者を適任と考えるかをIndeedが理解するのに役立ちます。このフィードバックはIndeedのマッチングモデルに直接反映され、より精緻な候補者レコメンデーションが可能になります。
ATSからの候補者応募者ステータスデータを使用することで、インデックス済み求人は全体で14%多くのポジティブな成果を得ています。
雇用主がIndeed エントリー連携をオプトアウトする一般的な理由は、任意のEEOおよび必須のノックアウト質問をサポートしていないことです。
Indeedには、すべての連携がスクリーナー質問をサポートし、米国の求人についてEEO質問をフラグ付けすることを要求する全社的な要件があります。雇用主は、人口統計質問の方法について引き続き責任を負います。すべての連携がUS求人のEEO質問のフラグ付けをサポートすることを要求することで、Indeedは求職者に一貫した体験を提供するより高品質な連携を推進しています。
クライアント認証情報はIndeed エントリーAPIトークンとシークレットです。これらの認証情報はパートナーコンソールでアクセスします。
Indeed エントリーの認証情報タイプを持つ共有APIシークレットを使用します。
Indeedは、HMAC-SHA1アルゴリズムを使用してメッセージ署名を計算します。この署名はHTTP X-Indeed-Signatureヘッダーとして送信されます。
Indeed エントリーは、POSTリクエストの真正性を確認するために使用できるHTTPヘッダーを含むPOSTリクエストをpostUrlに送信します。
現在、EEO/人口統計質問はEEOコンプライアンスのために米国ベースの求人に限定されています。
Indeedには資格タイプの質問があります。これらは非ブロッキ ング質問であり、回答が資格で定義された仕様を満たしていなくても、応募者は応募フローの次のセクションに進むことができます。この場合、応募は配信されます。
Indeed エントリー質問ツールを使用して、スクリーナー質問JSONファイルの構文を確認できます。このツールは、Indeed エントリー応募フローでスクリーナー質問がどのように表示されるかを示します。
求人や連携をライブにプッシュする前にテストするために、IndeedはIndeed エントリーXML設定テストツールを提供しています。設定可能なパラメータタブで、関連情報を入力してエンドツーエンドの応募フローのテストを開始します。
Indeed エントリー設定のテストをご覧ください。
POSTリクエストの場合、応募は同じ求人IDと同じ求職者メールアドレスからのIndeed応募が過去120日以内にある場合、重複とみなされます。
POSTリクエストへの応答時に応募が重複かどうかを判断する際、Indeed以外のソースから最初に送信された応募を使用しないでください。また、同じ求職者メールアドレスから同じ会社の別の求人IDへの応募を重複とみなさないでください。
URLでクロールされるXMLまたはお客様が提供するFTPサーバーでホストされるXMLの場合、Indeedは最後のリクエストの時刻から6時間間隔で1日4回求人データを更新します。Indeedホストのインポートシステムの場合、Indeedは新しいファイルを受信すると、2時間ごとの頻度でXMLフィードを更新します。より頻繁なファイルアップロードは求人データの更新を遅延させる可能性があります。フィードインデックスの遅延を修正するには、アップロードの頻度を減らしてください。
標準フィールドを含む限り、<branch_id>などの任意のフィールドを含めることができます。特定の情報をIndeedに表示する必要がある場合は、<description>フィールドを使用してください。
検索結果での表示は、Indeedの表示ルールに基づいています。検索品質チームは、正当で、ユニークで、詳細な説明と勤務地があり、応募しやすい求人を優先します。