広告代理店のシナリオ
クライアントの構成の違いがJob Update APIの使用にどう影響するかを説明します。
このAPIとそのドキュメントを使用して連携を構築すると、APIに関する追加の利用規約およびガイドラインに同意したことになります。
概要
広告代理店の場合、代理店が支援する雇用主がクライアントです。Indeed でそのクライアントの求人をどのように管理するかは、クライアントの構成によって決まります。
このガイドでは、代理店向けの主なシナリオと、それぞれで必要な対応を説明します。
シナリオ1: ATS 連携とサブアカウント
クライアントが Indeed エントリーに対応した ATS を使用しており、そのクライアント用のサブアカウントがあります。
これは最も一般的な代理店の構成です。Job Update API guide に従ってください。
シナリオ2: クロール求人またはホスト求人とサブアカウント
Indeed がクライアントのサイトをクロールして求人を取得しているか、クライアントが Indeed 上で直接求人を作成しており、そのクライアント用のサブアカウントがあります。
概要
Indeed Customer Support が、クライアントが連携求人ではなくクロール求人またはホスト求人を使用していることを確認した場合は、jobFeedType フィルターを使用してそれらの求人を取得します。
デフォルトでは、findEmployerJobsPartner は XML フィードまたは API 連携からの求人を返します。クロール求人またはホスト求人を取得するには、jobFeedType を明示的に設定してください。
要件
この方法を使用する前に、次を確認してください。
- クライアントがクロール求人またはホスト求人を使用していることを、Indeed Customer Support に確認します。
- 連携求人ではなく、クロール求人またはホスト求人を継続して使用したいことをクライアントに確認します。
実装
findEmployerJobsPartner を呼び出 す際は、jobFeedType フィルターを含めます。
クロール求人の場合:
query FindEmployerJobsPartner { findEmployerJobsPartner( input: { filters: { legacySourceId: "60a9614a5d973a21", jobFeedType: ["CRAWLED_FROM_WEB"] } }, first: 10 ) { employerJobs { id jobData { title } } }}ホスト求人の場合:
query FindEmployerJobsPartner { findEmployerJobsPartner( input: { filters: { legacySourceId: "60a9614a5d973a21", jobFeedType: ["CREATED_ON_INDEED"] } }, first: 10 ) { employerJobs { id jobData { title } } }}jobFeedType の有効な値
CRAWLED_FROM_WEB: Indeed がウェブから求人をクロールしたことを表します。CREATED_ON_INDEED: Indeed 上で直接求人が作成されたことを表します。INTEGRATED_FROM_PARTNER: XML フィードや Job API などのパートナーシステムが求人を送信したことを表します。デフォルト値です。UNKNOWN: Indeed が求人のフィードタイプを分類できないことを表します。
詳細については、findEmployerJobsPartner API リファレンス をご覧ください。
シナリオ3: 直接請求、サブアカウントなし
このクライアントのサブアカウントはありません。Indeed がクライアントに直接請求し、代理店がクライアントの求人コンテンツを管理します。
概要
Indeed がクライアントに直接請求しており、サブアカウントがない場合は、Job Update API を通じて求人コンテンツを管理する前に、クライアントの雇用主アカウントにアクセスできる必要があります。
要件
OAuth クライアント ID の作成に使用した開発者アカウントを、クライアントの雇用主アカウントに追加してもらいます。
実装
-
クライアントに開発者アカウントの追加を依頼する
OAuth クライアント ID の作成に使用した開発者アカウントを、セカンダリユーザーとして雇用主アカウントに追加するようクライアントに依頼します。クライアントは Indeed の Account ページから追加できます。
-
雇用主アカウントへのアクセスを確認する
クライアントが開発者アカウントを追加したら、次の手順で雇用主アカウントへのアクセスを確認します。
scope=employer_accessを指定してアクセストークンを取得します。https://secure.indeed.com/v2/api/appinfoエンドポイントを呼び出します。- レスポンスにクライアントの雇用主アカウントが表示されることを確認します。
-
雇用主を表すアクセストークンを取得する
アクセスを確認した後、Job Update API を呼び出すために、雇用主を表すアクセストークンを取得します。
トラブルシューティング
雇用主アカウントが一覧に表示されない
- クライアントが開発者アカウントをセカンダリユーザーとして追加したことを確認してください。
- クライアントが適切な権限を付与したことを確認してください。
- サポートが必要な場合は、Indeed Agency Customer Support の担当者にお問い合わせください。
雇用主を表すアクセストークンを取得できない
- 正しい開発者アカウントを使用していることを確認してください。
- OAuth クライアント ID を、クライアントが追加したものと同じ開発者アカウントで作成したことを確認してください。
- 詳細については、Troubleshoot OAuth errors をご覧ください。
詳細については、Get access token that represents employer および Sponsored Jobs API account management をご覧ください。
シナリオ4: ATS連携なし
クライアントの ATS が Indeed エントリーと連携していないため、代理店がクライアントの求人を Indeed に送信します。
概要
クライアントの ATS が Indeed エントリーと連携していない場合は、Job Update API を使用しません。代わりに、Job Sync API を使用して求人を Indeed に送信してください。
Job Sync API を使用するタイミング
次の場合は Job Sync API を使用します。
- クライアントの ATS が Indeed エントリーと連携していません。
- Indeed 上で求人を作成、更新、または期限切れにする必要があります。
- ATS 由来の既存求人を管理するのではなく、求人を Indeed に直接送信します。
次のステップ
- Job Sync API ドキュメン トを確認します。
- Job Sync API guide に従って求人管理を実装します。
関連ドキュメント
- Job Update API guide - シナリオ 1 の標準ワークフローです。
- Job Sync API - シナリオ 4 で求人を Indeed に直接送信する場合に使用します。
- Get access token that represents employer - シナリオ 3 に必要です。
- Sponsored Jobs API account management - 雇用主アカウントの詳細です。