広告代理店のシナリオ

クライアントの構成の違いがJob Update APIの使用にどう影響するかを説明します。

 

法的注意

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

概要

広告代理店の場合、代理店を採用した雇用主がクライアントです。クライアントの構成によって、Indeedでの求人管理方法が決まります。このガイドでは、広告代理店の主なシナリオと、それぞれで実施すべき対応について説明します。

シナリオ1: サブアカウントありのATS連携

クライアントがIndeed エントリー連携のあるATSを使用しており、そのクライアントのサブアカウントがあります。

このシナリオは、ほとんどの代理店とクライアントの関係に該当します。Job Update APIガイドに従ってください。

シナリオ2: サブアカウントありのクロール求人またはホスト求人

Indeedがクライアントのサイトをクロールして求人を取得するか、クライアントがIndeedで求人をホストしており、そのクライアントのサブアカウントがあります。

概要

Indeedカスタマーサポートが、クライアントが連携求人ではなくクロール求人またはホスト求人を使用していることを確認した場合は、jobFeedTypeフィルターを使用してそれらの求人を取得します。

デフォルトでは、findEmployerJobsPartnerはXMLフィードまたはAPI連携からの求人を返します。クロール求人またはホスト求人を取得するには、jobFeedTypeフィルターを設定してください。

要件

この方法を使用する前に、次を確認してください。

• クライアントがクロール求人またはホスト求人を使用していることを、Indeedカスタマーサポートに確認します。
• 連携求人ではなくクロール求人またはホスト求人を使用したいことを、クライアントに確認します。

実装

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が求人フィードタイプを分類できません。

jobFeedTypeフィルターの詳細については、findEmployerJobsPartner APIリファレンスをご覧ください。

シナリオ3: 直接請求、サブアカウントなし

このクライアントのサブアカウントはありません。Indeedがクライアントに直接請求し、あなたがクライアントの求人コンテンツを管理します。

概要

Indeedがクライアントに直接請求し、サブアカウントがない場合は、Job Update APIを通じてクライアントの求人コンテンツを管理するために、クライアントの雇用主アカウントへのアクセス権が必要です。

要件

クライアントに、OAuthクライアントIDの作成に使用した開発者アカウントを、雇用主アカウントに追加してもらいます。

実装

1. クライアントに開発者アカウントの追加を依頼する

   OAuthクライアントIDの作成に使用した開発者アカウントを、セカンダリユーザーとして雇用主アカウントに追加するようクライアントに依頼します。クライアントはIndeedのAccountページから追加できます。

2. 雇用主アカウントへのアクセスを確認する

   クライアントが開発者アカウントを追加したら、雇用主アカウントへのアクセスを確認します。

   • scope=employer_accessを指定してアクセストークンを取得します。

   • https://secure.indeed.com/v2/api/appinfoエンドポイントを呼び出します。

     クライアントの雇用主アカウントが一覧に表示されます。

3. 雇用主を表すアクセストークンを取得する

   アクセスを確認した後、Job Update APIを呼び出すために、雇用主を表すアクセストークンを取得します。

トラブルシューティング

雇用主アカウントが一覧に表示されない

• クライアントが、OAuthクライアントIDの作成に使用した開発者アカウントをセカンダリユーザーとして追加したことを確認してください。
• クライアントが適切な権限を付与したことを確認してください。
• サポートが必要な場合は、Indeed Agency Customer Supportの担当者にお問い合わせください。

雇用主を表すアクセストークンを取得できない

• 正しい開発者アカウントを使用していることを確認してください。
• OAuthクライアントIDを、クライアントが追加した開発者アカウントで作成したことを確認してください。
• 詳細については、OAuthエラーのトラブルシューティングをご覧ください。

雇用主アカウントへのアクセスの詳細については、雇用主を表すアクセストークンを取得するおよび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ガイドに従って、求人管理を実装します。

関連ドキュメント

• Job Update APIガイド - シナリオ1の標準ワークフロー
• Job Sync API - シナリオ4向け（求人をIndeedに直接送信する場合）
• 雇用主を表すアクセストークンを取得する - シナリオ3に必要
• Sponsored Jobs API account management - 雇用主アカウント情報

 

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