Job Update API ガイド

Indeed の求人を更新し、更新をクリアし、求人の詳細を取得し、求人を一覧表示します。

 

法的注意

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

Job Update API のワークフロー

Indeed 上の求人を更新し、更新をクリアし、詳細を取得し、一覧表示します。呼び出しは無料で、Sponsored Jobs API usage policy の制限には含まれません。

1. 1.
   開始前に確認する - single-source policy に基づき、雇用主の求人の正規ソースは ATS です。
2. 2.
   認証する。
3. 3.
   求人を更新する - 広告代理店は updateSourcedJobPostings を呼び出して求人フィールドを更新します。
4. 4.
   求人情報を取得するクエリ方法を選択する。
5. 5.
   ID で求人ステータスを取得する。求人 IRI がある場合は、GraphQL の node クエリまたは nodes クエリを呼び出します。
6. 6.
   条件で求人を一覧表示する。求人を一括取得するには、findEmployerJobsPartner を呼び出します。
7. 7.
   求人の更新をクリアする - 広告代理店は求人の更新をクリアできます。
8. 8.
   求人ステータスを確認する。
9. 9.
   レート制限を確認する。
10. 10.
    GraphQL エラーをトラブルシューティングする - GraphQL エラーを解決します。

Job Update API のリファレンス

• updateSourcedJobPostings - 広告代理店は求人フィールドを更新できます。
• node - ID で求人ステータスを取得します。
• nodes - ID で求人を一覧表示します。
• findEmployerJobsPartner - 雇用主の求人を一覧表示します。
• clearSourcedJobPostingUpdates - 広告代理店は求人の更新をクリアできます。

ATS が求人の作成と期限切れを管理します。

認証

When you become an Indeed partner, Indeed sets up an app for your integration. Sign in to Partner Console to view your app and OAuth credentials (client ID, secret, and authorization code for 3-legged OAuth). Exchange credentials for an access token to authenticate API calls.

Indeed と連携して API を呼び出す をご覧ください。

findEmployerJobsPartner、node、nodes の各クエリを使用するには、次のいずれかの OAuth トークンタイプが必要です。

OAuth トークンタイプ

トークンタイプ	説明
広告主を指定する 2‑legged OAuth トークン	広告代理店であり、Sponsored Jobs API を client credentials grant type (2-legged OAuth) とともに使用している場合は、すでにこのトークンタイプを持っています。
3-legged OAuth トークン	すでに 3-legged OAuth トークンを持っている場合は、代わりに使用できます。

OAuth アクセストークンには、次のスコープが必要です。

• employer_access
• employer.hosted_job

OAuth トークンにスコープを追加する方法の詳細については、Scopes をご覧ください。

アクセストークンを取得したら、クエリにこのトークンを含めます。更新された求人ステータスを表示するたびにユーザーが毎回サインインしなくてよいように、Indeed はアクセストークンの有効期限が切れる前に更新することを推奨します。

求人を更新する

この機能はベータ版であり、日本では利用できません。詳細については Indeed にお問い合わせください。

Indeedの求人のupsertとupdateの使い分け

• 自社がIndeedに送信した求人は、upsertします。
• 別のパートナーが送信した求人は、updateします。updateは主に広告代理店向けです。

日本のみ：広告代理店およびIndeed PLUSパブリッシャーネットワークのパートナーを除き、すべてのパートナーが求人をupdateできます。

関連項目：

• 求人をupsertする
• 求人をupdateする

広告代理店がIndeedおよびIndeed PLUS上で求人のフィールドを更新できるようにします。

クライアントから認可された求人のみを更新してください。認可されていない更新を行うと、クライアントがその求人で他のIndeedツールを使用できなくなることがあります。ATSにない勤務地を追加する場合は、自社のXMLまたはAPI連携を使用してください。

ワークフロー

Indeed に送信していない求人を更新するには、次の手順に従います。

ワークフロー - 求人を更新する

#	説明	参照先
1.	追加するクライアントを選択する: Indeed にお問い合わせください。
2.	条件で求人を一覧表示する: findEmployerJobsPartner を呼び出します。レスポンスで JobPostSurfaceStatus.isRejected が false の求人を確認します。これらの求人は Indeed で Searchable として表示されます。後続の API 呼び出しに備えて EmployerJob.id を保存します。	条件で求人を一覧表示する findEmployerJobsPartner JobPostSurfaceStatus.isRejected EmployerJob.id
3.	求人を更新する: トラッキング URL や求人 URL などのフィールドを更新するには、updateSourcedJobPostings を呼び出します。あるフィールドを更新すると、そのフィールドに対する後続の ATS 変更は求職者には表示されなくなります。更新可能なフィールドについては、UpdateSourcedJobPostingMetadataInput と UpdateSourcedJobPostingBodyInput をご覧ください。	求人を更新する updateSourcedJobPostings sourcedPostingId EmployerJob.id UpdateSourcedJobPostingMetadataInput UpdateSourcedJobPostingBodyInput
4.	更新を確認する: 更新を確認するには、次のいずれかの方法を呼び出します。 findEmployerJobsPartner: アクセストークンごとに 1 時間に 1 回この操作を呼び出します。Indeed はパートナーごとに異なるスケジュールで ATS の求人を受信します。求人の更新は通常 30 秒以内に反映されますが、Indeed はこれを保証しません。 node クエリ（id に EmployerJob.id を設定）: 1 件の求人を取得して変更を確認します。 nodes クエリ（ids に EmployerJob.id の配列を設定）: 1 回の呼び出しで複数の求人を取得します。 キャンペーンのスポンサー求人を一覧表示するには、campaignCategories を ad_campaign_category:{category} に設定します。たとえば、ad_campaign_category:foo を指定すると、foo キャンペーンのスポンサー求人が返されます。	findEmployerJobsPartner node nodes EmployerJob.id campaignCategories

この呼び出しのレート制限については、レート制限 をご覧ください。

リクエスト - 求人を更新する

求人内の選択したフィールドを更新するには、広告代理店は jobsIngest.updateSourcedJobPostings ミューテーションを呼び出します。

この操作には、広告主を表すアクセストークンが必要です。

OAuth アクセストークンには、次のスコープが必要です。

• employer_access
• employer.hosted_job

雇用主を表すアクセストークンを取得する をご覧ください。雇用主 ID ではなく、広告主 ID にトークンを関連付けます。

更新するフィールドだけを指定します。フィールドを変更しない場合は、null に設定するか省略します。

この例では、updateSourcedJobPostings ミューテーションを呼び出して、求人の複数のフィールドを更新します。

mutation UpdateSourcedJobPostings {
  jobsIngest {
    updateSourcedJobPostings(
      input: {
        updates: [
          {
            sourcedPostingId: "<SOURCED POSTING ID OF JOB POSTING>"
            metadata: {
              url: "https://www.example.com/jobs/123"
              campaignCategories: ["springCampaign"]
              trackingUrl: "https://www.example.com/jobs/123?utm_source=indeed"
            }
            body: {
              title: "Software Developer"
              description: "Come build the future with us!"
              jobLocation: {
                general: {
                  cityRegionPostal: "Phoenix, AZ 85003"
                  streetAddress: "1234 Sunny Lane, Phoenix, AZ 85003"
                }
              }
              salary: {
                currency: "USD"
                maximumMinor: 1000
                minimumMinor: 1000
                period: "HOUR"
              }
            }
          }
        ]
      }
    ) {
      results {
        jobPosting {
          sourcedPostingId
          employerJobId
        }
      }
    }
  }
}

mutation UpdateSourcedJobPostings {
  jobsIngest {
    updateSourcedJobPostings(input: {
      updates: [{
        sourcedPostingId: "<SOURCED POSTING ID OF JOB POSTING>"
        body: {
          description: "<h2>About the role</h2><p>Join our team as a software engineer. You design and build scalable backend services.</p><ul><li>Competitive salary</li><li>Remote-friendly</li><li>Health and dental benefits</li></ul>"
          descriptionFormatting: HTML
        }
      }]
    }) {
      results {
        jobPosting {
          sourcedPostingId
          employerJobId
        }
      }
    }
  }
}

updateSourcedJobPostings は 1 つの引数 input を受け取ります。型は UpdateSourcedJobPostingsInput です。

input は 1 つのフィールド updates を受け取ります。これは UpdateSourcedJobPostingInput オブジェクトの配列です。各 UpdateSourcedJobPostingInput オブジェクトは、1 件の求人に対する更新内容を定義します。

各 UpdateSourcedJobPostingInput オブジェクトには、次のフィールドがあります。

リクエスト - 求人を更新する

フィールド	型	説明
sourcedPostingId	ID!	必須。 各求人について、次のいずれかの値を指定します。 SourcedJobPosting.sourcedPostingId。これは jobsIngest.createSourcedJobPostings が返す値です。求人を作成する をご覧ください。 EmployerJob.id。これは findEmployerJobsPartner が返す値です。求人を一覧表示する をご覧ください。
metadata.url	WebUrl	Indeed エントリーを利用できない場合に、求職者が応募できる広告代理店側の URL です。
metadata.campaignCategories	[String!]	キャンペーン求人の選定で関連する求人をまとめるカテゴリタグです。指定した campaignCategories の値に対して、ad_campaign_category:{category} を使って Sponsored Jobs API クエリを作成します。
metadata.trackingUrl	WebUrl	求人トラッキング URL です。求職者が Indeed 上で求人を表示すると、Indeed はこの URL に HTTP リクエストを送信します。
body.title	String	求人タイトルです。
body.description	String	求人の説明です。 プレーンテキスト (TEXT): 30 文字以上 20,000 文字以下 HTML (HTML): 最小 30 文字、最大 65,000 バイト（UTF-8）。上限はバイト数で評価されます。マルチバイト文字も上限に含まれます。サポートされるタグについては、Job description formatting をご覧ください。 変更しない場合は、このフィールドを省略するか null に設定します。
body.descriptionFormatting	DescriptionFormatting	求人説明の形式です。HTML 書式を有効にするには、このフィールドを HTML に設定します。デフォルトは TEXT です。
body.jobLocation .general.cityRegionPostal	String!	所在地を更新する場合は必須。 求人の市区町村、州、郡、都道府県などの行政区域、および郵便番号です。 リモート求人にこのフィールドを設定すると、Indeed はその求人を regional remote job として扱います。
body.jobLocation .general.streetAddress	String	求人の主な勤務地の番地です。通り名と番地を含む完全な住所を指定します。Indeed はこの住所を使用して所在地ベースのマッチングを改善し、求職者に住所を表示できます。
body.salary.currency	CurrencyCode	ISO 4217 形式の給与通貨コードです。
body.salary.maximumMinor	Int64	現地通貨の最小単位で表した給与上限です。たとえば USD の最小通貨単位はセントであるため、1,000 は 10 ドルを表します。現在の値をクリアするには、このフィールドを null に設定するか省略します。
body.salary.minimumMinor	Int64	現地通貨の最小単位で表した給与下限です。たとえば USD の最小通貨単位はセントであるため、1,000 は 10 ドルを表します。現在の値をクリアするには、このフィールドを null に設定するか省略します。
body.salary.period	JobSalaryPeriod!	給与を更新する場合は必須。 時給、日給、週給など、給与計算に使用する単位です。
body.companyName	String	求人の会社名を更新します。変更しない場合は、このフィールドを null に設定するか省略します。最大長は 200 文字です。

これらのフィールドの詳細については、API リファレンス をご覧ください。

更新を確認する

変更内容を検証するために、updateSourcedJobPostings のレスポンスには求人 IRI が含まれます。返された IRI で node クエリを使用します。

ID で求人ステータスを取得する をご覧ください。

部分更新

フィールドの更新はアトミックではありません。1 回のリクエストで複数のフィールドを更新すると、まれに API が一部の変更だけを適用することがあります。この場合、レスポンスには常にエラーが含まれます。ただし、エラーレスポンスが返ったからといって、必ず部分更新が発生したとは限りません。複数のフィールドを更新するリクエストでエラーが返された場合は、更新された求人を表示する ことで、正常に更新されたフィールドがあるかどうかを確認できます。エラー処理のガイダンスについては、GraphQL エラーをトラブルシューティングする をご覧ください。

レスポンス - 求人を更新する

updateSourcedJobPostings は UpdateSourcedJobPostingsPayload オブジェクトを返します。このオブジェクトには results フィールドが含まれます。これは UpdateSourcedJobPostingResult オブジェクトの配列です。各オブジェクトは 1 件の求人更新結果に対応します。

各 UpdateSourcedJobPostingResult オブジェクトには、型 SourcedJobPostingUpdate の jobPosting フィールドが含まれます。Indeed が更新を受け付けなかった場合、このフィールドは null です。それ以外の場合は、次の求人情報が含まれます。

• sourcedPostingId: 求人 UUID です。これは Indeed が求人作成時に生成した SourcedJobPosting.sourcedPostingId と同じ値です。この値は求人の期限切れや更新に使用します。
• employerJobId: 求人の Indeed Resource Identifier（IRI）です。これは EmployerJob.id と同じ値です。

求人情報を取得するクエリ方法を選択する

求人情報を取得するには、次のいずれかの方法を使用します。

求人情報を取得するクエリ方法を選択する

方法	説明
ID で求人ステータスを取得する（node または nodes クエリ）	この方法は、EmployerJob ID である求人 IRI による直接検索に使用します。 すでに求人 IRI がある場合、この方法は findEmployerJobsPartner より高速です。 使用例: 求人を更新して変更を確認する: updateSourcedJobPostings を呼び出して、EmployerJob ID である求人 IRI を取得します。その後、node クエリ を使って更新を確認します。 webhook: webhook を受信した後、ペイロード内の求人 IRI を使って node クエリ を呼び出し、現在の求人ステータスを取得します。
条件で求人を一覧表示する（findEmployerJobsPartner）	この検索ベースの方法は、すべての求人を一覧表示する場合に使用します。求人在庫の一括取得に最適です。 使用例: 在庫同期: IRI を持っていない場合は、定期的に在庫を同期します。findEmployerJobsPartner を呼び出して、関連付けられたすべての求人を一括取得します。利用できるフィルターは legacySourceId と feedType のみです。

ID で求人ステータスを取得する

EmployerJob ID である IRI で求人ステータスを取得するには、GraphQL の node クエリまたは nodes クエリを呼び出します。これらのクエリは、条件で求人を一覧表示する より効率的です。

認証

findEmployerJobsPartner と同じ認証および認可を使用します。認証 をご覧ください。OAuth アクセストークンには、次のスコープが必要です。

• employer_access
• employer.hosted_job

単一求人クエリ (node)

Relay Node パターンを使って、EmployerJob ID である IRI により 1 件の求人を取得します。

query GetJob($id: ID!) {
  node(id: $id) {
    ...on EmployerJob {
      id
      jobData {
        title
        description
        company
        dateCreated
        datePostedOnIndeed
        jobLocation {
          city
          countryCode
          fullAddress
        }
        salary {
          max
          min
          period
        }
        externalPostingMetadata {
          jobPostingId
          jobRequisitionId
        }
      }
      managementUrls {
        viewJob
      }
    }
  }
}

変数:

{
  "id": "dXJuOmluZGVlZDplbXBsb3llcmpvYjphMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTA="
}

求人 IRI（EmployerJob ID）は base64 でエンコードされた値です。レスポンスの id フィールドには、エンコード済みの IRI が返されます。

EmployerJob をご覧ください。

POST https://apis.indeed.com/graphql
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "query": "query GetJob($id: ID!) { node(id: $id) { ... on EmployerJob { id jobData { title description company } } } }",
  "variables": {
    "id": "dXJuOmluZGVlZDplbXBsb3llcmpvYjphMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTA="
  }
}

複数求人クエリ (nodes)

複数の求人について、EmployerJob ID である各 IRI を使ってステータスを取得します。

複数の求人更新の確認、バッチ処理、または webhook イベントの処理に使用します。

query GetMultipleJobs($ids: [ID!] !) {
  nodes(ids: $ids) {
    ... on EmployerJob {
      id
      jobData {
        title
        description
        company
        datePostedOnIndeed
        jobLocation {
          city
          countryCode
        }
      }
    }
  }
}

変数:

{
  "ids": [
    "dXJuOmluZGVlZDplbXBsb3llcmpvYjphMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTA=",
    "dXJuOmluZGVlZDplbXBsb3llcmpvYjpiMmMzZDRlNS1mNmE3LTg5MDEtYmNkZS1mMjM0NTY3ODkwMTI=",
    "dXJuOmluZGVlZDplbXBsb3llcmpvYjpjM2Q0ZTVmNi1hN2I4LTkwMTItY2RlZi0zNDU2Nzg5MDEyMzQ="
  ]
}

求人 IRI（EmployerJob ID）は base64 でエンコードされた値です。レスポンスの id フィールドには、エンコード済みの IRI が返されます。

EmployerJob をご覧ください。

webhook を使用する

webhook ペイロードには求人 IRI が含まれます。

{
  "eventType": "job.updated",
  "jobIri": "dXJuOmluZGVlZDplbXBsb3llcmpvYjphMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTA=",
  "timestamp": "2025-12-10T15:30:00Z"
}

IRI を指定して node クエリを使用し、求人ステータスを取得します。クエリ例については、ID で求人ステータスを取得する をご覧ください。

利点:

• リアルタイムの更新
• IRI ベースの高速な取得
• 表示前のデータ補完ウィンドウ

条件で求人を一覧表示する

この機能を使用するには Indeed へのお問い合わせが必要です。追加要件があります。

雇用主の求人を一覧表示します。

この呼び出しにはレート制限があります。

クライアントごとに 1 時間に 1 回、条件で求人を一覧表示する呼び出しを行う場合は、レート制限に達しないことがあります。ただし、HTTP 429 エラーが発生する場合があります。その場合は、リクエストレートを下げてください。429 error code をご覧ください。

この呼び出しのレート制限については、レート制限 をご覧ください。

リクエスト - 条件で求人を一覧表示する

雇用主の求人を一覧表示するには、findEmployerJobsPartner クエリを呼び出します。

この例では、findEmployerJobsPartner クエリを呼び出して、Indeed に掲載された日付の降順で条件に一致する求人を一覧表示します。

query FindEmployerJobsPartner {
  findEmployerJobsPartner(input: {
    filters: {
      legacySourceId: "60a9614a5d973a21",
      jobFeedType: ["INTEGRATED_FROM_PARTNER"]
    },
    sort: [{
      sortDirection: DESC,
      sortField: datePostedOnIndeed
    }]
  }, first: 10, before: null, after: null) {
    employerJobs {
      id
      jobData {
        title
        datePostedOnIndeed
        dateCreated
        description
        company
        jobLocation {
          countryCode
          city
          postalCode
          fullAddress
        }
        externalJobPageUrl
        externalPostingMetadata {
          jobPostingId
          jobRequisitionId
          campaignCategories
          trackingUrls
          rawInputLocation
          isIntegratedJob
        }
      }
      managementUrls {
        viewJob
      }
      seatsConnection {
        pageInfo {
          endCursor
          hasNextPage
          hasPreviousPage
          startCursor
        }
        seats {
          jobPost {
            id
            externalPartnerCallToAction(input: {
              locale: "en-us"
            }) {
              imageAltText
              imageUrl
            }
            status {
              globalStatus {
                isIndeedApplyActive
              }
              surfaceStatuses {
                isRejected
                isSponsorshipRequired
                isMissingRequiredSponsorship
              }
            }
          }
        }
      }
    }
    estimatedTotalResultsCount
    pageInfo {
      endCursor
      hasNextPage
      hasPreviousPage
      startCursor
    }
  }
}

findEmployerJobsPartner は、ソース ID で求人を検索するか、雇用主の求人を一覧表示します。次の入力フィールドを受け取ります。

条件で求人を一覧表示するフィールド

フィールド	説明
input.filters.jobFeedType	求人ソースであるフィードタイプで求人をフィルタリングします。 フィードタイプが UNKNOWN の場合は、2 つのフィードタイプを指定できます。それ以外の場合は 1 つのみ指定できます。 有効な値は次のとおりです。 CREATED_ON_INDEED。Indeed で直接作成された求人です。 INTEGRATED_FROM_PARTNER。XML フィードや Job API など、パートナーシステムから連携された求人です。 CRAWLED_FROM_WEB。インターネットから取得された求人です。 UNKNOWN。不明または分類されていないフィードタイプの求人です。フィードタイプを割り当てるための十分なソースデータがまだない求人が含まれることがあります。 デフォルト: INTEGRATED_FROM_PARTNER と UNKNOWN クライアントの求人が Web クローリングによるもの、または Scenario 2 で Indeed にホストされているものである場合は、正しい jobFeedType フィルターを指定します。デフォルトでは、findEmployerJobsPartner は XML や API フィードなどの連携からの求人のみを返します。詳細については、Scenario 2 の詳細 をご覧ください。
input.sort	レスポンス内の求人の並び順を定義するオブジェクト配列です。各オブジェクトには次のフィールドがあります。 sortDirection: 求人を ASC または DESC の順序で一覧表示するかを制御します。 デフォルト: ASC。sortField の値が小さいものから大きいものへ並び替えます。 sortField: 求人の並び替えに使用するフィールドを定義します。このフィールドを省略すると、sortDirection は効果を持ちません。
first	返す求人件数です。 デフォルト: 10 最大: 500
before	この値より前のカーソル値を持つ項目を取得します。ページネーションの詳細を取得するには、レスポンス内の PageInfo オブジェクトを使用します。
after	この値より後のカーソル値を持つ項目を取得します。ページネーションの詳細を取得するには、レスポンス内の PageInfo オブジェクトを使用します。

レスポンス - 条件で求人を一覧表示する

findEmployerJobsPartner は、API 呼び出しに使用したアクセストークンに関連付けられた雇用主の求人を一覧表示します。

リクエストで FindEmployerJobsPartnerInput.filter または FindEmployerJobsPartnerInput.sort を指定すると、API はレスポンス内の求人をフィルタリングおよび並び替えします。

API トークンで期待した求人が返らない場合は、Indeed の雇用主アカウントページから Indeed のサポート担当者に連絡するようユーザーに案内します。必要に応じて、その担当者が Indeed 上の求人を広告主またはユーザーの Indeed アカウントに接続できる場合があります。

API は FindEmployerJobsPartnerConnection レスポンスオブジェクトを返します。含まれるフィールドは次のとおりです。

レスポンス - 条件で求人を一覧表示する

フィールド	型	説明
employerJobs	[EmployerJob]!	求人オブジェクトの配列です。各オブジェクトのフィールドについては、レスポンス - 求人を表示する の表をご覧ください。
estimatedTotalResultsCount	Int!	レスポンス内の求人総数の推定値です。
pageInfo	PageInfo!	ページネーション情報です。

次の例は、求人を一覧表示するレスポンスです。

API は seats に 1 件だけを返すため、startCursor と endCursor は同じ値になり、hasNextPage と hasPreviousPage は false になります。

{
  "data": {
    "node": {
      "id": "aXJpOi8vYXBpcy5pbmRlZWQuY29tL0VtcGxveWVySm9iLzkxZGU0ZjVhLWE1MWYtNGQ1Ni1iOWI0LWNhMDQzZWVjNDAzMQ==",
      "jobData": {
        "title": "Certified Nursing Assistant CNA",
        "datePostedOnIndeed": "2022-03-22T20:33:28Z",
        "dateCreated": "2022-03-22T20:33:28Z",
        "description": "Anytown Health and Rehabilitation Center in Anytown, USA is a 186-bed center offering a variety of individualized, health care services for our patients and residents. We are seeking a qualified and committed team member to join our team.",
        "company": "Anytown Health and Rehabilitation Center",
        "jobLocation": {
          "countryCode": "US",
          "city": "Cambridge",
          "postalCode": null,
          "fullAddress": null
        },
        "externalJobPageUrl": "http://www.indeed.com/job/certified-nursing-assistant-cna-9354ed892ad3a1b6",
        "externalPostingMetadata": {
          "jobPostingId": "CBA-Anytown-Posting-Id",
          "jobRequisitionId": "CBA-Anytown-Req-Id",
          "campaignCategories": [],
          "trackingUrls": [],
          "isIntegratedJob": false
        }
      },
      "managementUrls": {
        "viewJob": "https://employers.indeed.com/jobs/view?employerJobId=aXJpOi8vYXBpcy5pbmRlZWQuY29tL0VtcGxveWVySm9iLzkxZGU0ZjVhLWE1MWYtNGQ1Ni1iOWI0LWNhMDQzZWVjNDAzMQ=="
      },
      "seatsConnection": {
        "pageInfo": {
          "endCursor": "YVhKcE9pOHZZWEJwY3k1cGJtUmxaV1F1WTI5dEwwcHZZbEJ2YzNRdk5EQXhOVFkxTW1OaFpEYzJZVFF4TlE9PQ==",
          "hasNextPage": false,
          "hasPreviousPage": false,
          "startCursor": "YVhKcE9pOHZZWEJwY3k1cGJtUmxaV1F1WTI5dEwwcHZZbEJ2YzNRdk5EQXhOVFkxTW1OaFpEYzJZVFF4TlE9PQ=="
        },
        "seats": [
          {
            "jobPost": {
              "id": "aXJpOi8vYXBpcy5pbmRlZWQuY29tL0pvYlBvc3QvNDAxNTY1MmNhZDc2YTQxNQ==",
              "externalPartnerCallToAction": [
                {
                  "imageUrl": "https://dlogqfjusi9uq.cloudfront.net/cta/en_US/not_searchable.svg",
                  "imageAltText": "Update needed on Indeed"
                }
              ],
              "status": {
                "globalStatus": [
                  {
                    "lifecycleStatus": "INACTIVE",
                    "isIndeedApplyActive": false
                  }
                ],
                "surfaceStatuses": [
                  {
                    "isRejected": false,
                    "isSponsorshipRequired": false,
                    "isMissingRequiredSponsorship": false
                  }
                ]
              }
            }
          }
        ]
      }
    }
  }
}

バリデーションエラーをトラブルシューティングするには、GraphQL エラーをトラブルシューティングする をご覧ください。バリデーションエラーの詳細については、GraphQL ドキュメントの Validation をご覧ください。

求人の更新をクリアする

このベータ機能は日本では利用できません。詳細については Indeed にお問い合わせください。

クライアントの求人を更新した広告代理店は、後からその更新をクリアできます。

ワークフロー

広告代理店は、この操作を呼び出して、自社が求人に対して行った更新をクリアできます。

たとえば、あるクライアントとの連携を今後行わない場合、この操作を使用してそのクライアントの求人に加えた更新をクリアします。この操作により、その求人には最新の ATS データが復元されます。その後、クライアントは他の Indeed ツールを使用して再びその求人を管理できます。

ワークフロー - 求人の更新をクリアする

#	説明	参照先
1.	求人を更新する: クライアントを追加し、その求人を更新します。	求人を更新する
2.	条件で求人を一覧表示する: findEmployerJobsPartner を呼び出します。ここで legacySourceId には、求人更新操作が返した sourcedPostingId を設定します。	条件で求人を一覧表示する findEmployerJobsPartner legacySourceId sourcedPostingId
3.	求人の更新をクリアする: 求人内の更新済みフィールドをクリアします。clearSourcedJobPostingUpdates を呼び出します。求人の更新をクリアすると、その求人の更新済みフィールドはすべて最新の ATS データに戻ります。	求人の更新をクリアする clearSourcedJobPostingUpdates
4.	条件で求人を一覧表示する: findEmployerJobsPartner を呼び出します。ここで legacySourceId には、求人更新操作が返した sourcedPostingId を設定します。	条件で求人を一覧表示する findEmployerJobsPartner legacySourceId sourcedPostingId

この呼び出しのレート制限については、レート制限 をご覧ください。

リクエスト - 求人の更新をクリアする

updateSourcedJobPostings が以前に更新した求人フィールドをクリアするには、広告代理店は jobIngest.clearSourcedJobPostingUpdates ミューテーションを呼び出します。

この操作には、もとの更新を行った広告主を表すアクセストークンが必要です。

OAuth アクセストークンには、次のスコープが必要です。

• employer_access
• employer.hosted_job

雇用主を表すアクセストークンを取得する をご覧ください。雇用主 ID ではなく、広告主 ID にトークンを関連付けます。

この例では、clearSourcedJobPostingUpdates ミューテーションを呼び出して、求人から更新をクリアします。

mutation ClearSourcedJobPostingUpdates {
  jobsIngest {
    clearSourcedJobPostingUpdates(input: {
      updates: [{
        sourcedPostingId: "<SOURCED POSTING ID OF JOB POSTING>"
      }]
    }) {
      results {
        jobPosting {
          sourcedPostingId
          employerJobId
        }
      }
    }
  }
}

clearSourcedJobPostingUpdates は 1 つの引数 input を受け取ります。型は ClearSourcedJobPostingUpdatesInput です。

input は 1 つのフィールド updates を受け取ります。これは ClearSourcedJobPostingUpdateInput オブジェクトの配列です。各 ClearSourcedJobPostingUpdateInput オブジェクトは、更新をクリアする対象の求人を識別します。

1 回のリクエストで複数の求人の更新をクリアするには、複数の ClearSourcedJobPostingUpdateInput オブジェクトを含めます。

各 ClearSourcedJobPostingUpdateInput オブジェクトには、次のフィールドがあります。

リクエスト - 求人の更新をクリアする

フィールド	型	説明
sourcedPostingId	ID!	必須です。各求人について、次のいずれかの値を指定します。 SourcedJobPosting.sourcedPostingId。これは jobsIngest.createSourcedJobPostings が返す値です。求人を作成する をご覧ください。 EmployerJob.id。これは findEmployerJobsPartner が返す値です。条件で求人を一覧表示する をご覧ください。

レスポンス - 求人の更新をクリアする

clearSourcedJobPostingUpdates は ClearSourcedJobPostingUpdatesPayload オブジェクトを返します。このオブジェクトには results フィールドが含まれます。これは ClearSourcedJobPostingUpdateResult オブジェクトの配列です。各オブジェクトは、更新がクリアされた 1 件の求人に対応します。

各 ClearSourcedJobPostingUpdateResult オブジェクトには、型 SourcedJobPostingUpdate の jobPosting フィールドが含まれます。Indeed が更新クリアのリクエストを受け付けなかった場合、このフィールドは null です。それ以外の場合は、求人に関する次の情報が含まれます。

• sourcedPostingId: 求人 UUID です。この値は、Indeed が求人作成時に生成した SourcedJobPosting.sourcedPostingId と一致します。この値は求人の期限切れや更新に使用します。

• employerJobId: 求人の Indeed Resource Identifier（IRI）です。この値は EmployerJob.id と一致します。

求人ステータス

フィードポリシーが変更されたため、現在、Indeed 上で管理する求人の大半はお客様のフィードから取得されません。以前は、求職者がキャリアページに移動したときのオーガニックトラフィックデータを取得できた場合があります。

求人ステータス

求人ステータス	ブール値	参照先
オーガニック	“isRejected”: false “isSponsorshipRequired”: false	オーガニックの非スポンサー求人
スポンサーのみ（予算あり）	“isRejected”: false “isSponsorshipRequired”: true “isMissingRequiredSponsorship”: false	スポンサー求人
スポンサーのみ（予算なし）	“isRejected”: true “isSponsorshipRequired”: true “isMissingRequiredSponsorship”: true
どこにも表示されない	“isRejected”: true “isSponsorshipRequired”: false

オーガニックの非スポンサー求人

スポンサーされていない求人のオーガニックトラフィックデータを取得するには、次のいずれかの方法を使用します。

オーガニックトラフィックデータを取得する

方法		説明
1.	trackingUrl フィールドを追加する	求人がクリックされるたびに HTTP リクエストを受け取るには、次のいずれに当てはまる場合でも、このフィールドを求人に追加します。 求人がオーガニックトラフィックまたはスポンサートラフィックを受けるかどうか。 求人が Indeed エントリーを使用するかどうか。 UpdateSourcedJobPostingMetadataInput 入力オブジェクトの trackingUrl をご覧ください。
2.	カスタム求人 URL を使用する	求人 URL を自社のキャリアページに置き換えるか、ATS パートナーと連携して求人 URL にトラッキングメタデータを付加します。 求人で Indeed エントリーを使用しない場合、求職者はこの URL に移動します。Indeed エントリーを使用する場合、求職者はこの URL に移動しません。 UpdateSourcedJobPostingMetadataInput 入力オブジェクトの url をご覧ください。
3.	クライアントの ATS と連携する	クライアントとその ATS と連携して、オーガニックパフォーマンスデータを収集します。
4.	クライアントに Indeed Analytics へサインインしてもらう	クライアントは Indeed Analytics にサインインして、スポンサーの有無にかかわらず、すべての求人の完全なオーガニックパフォーマンスを確認できます。この画面では、アカウントデータ全体を確認できます。

スポンサー求人

スポンサー求人のトラフィックデータを取得するには、Sponsored Jobs API v8 以降を呼び出して、Job Update API が返す ID と一致する雇用主求人 ID を取得します。

レート制限

Job Update API は、次のクエリとミューテーションの呼び出しにレート制限を適用します。

• findEmployerJobsPartner クエリによる条件で求人を一覧表示する
• jobsIngest.updateSourcedJobPostings ミューテーションによる求人を更新する
• jobsIngest.clearSourcedJobPostingUpdates ミューテーションによる求人の更新をクリアする

これらの制限は、API の可用性維持に役立つベストプラクティスに従っています。Indeed は通常の日常的な Job Update API 利用量を上回る範囲で制限値を設定していますが、短時間に大量のリクエストが発生するとスロットリングし、再試行を要求します。レート制限に達しないようにするには、API リクエストを 10 分間に分散します。

レート制限を超えると、API は HTTP 429 を返します。返却場所は HTTP レベル、または GraphQL JSON レスポンス内の errors 配列 です。

特別な対応は必要ありません。これらの制限への対処で支援が必要な場合は、サポートを依頼してください。

これらのレート制限を超えると、API は次のように通知します。

Job Update API のレート制限

クエリまたはミューテーション	レート制限
findEmployerJobsPartner クエリ	1 秒あたり 5 リクエスト
jobsIngest.updateSourcedJobPostings ミューテーション	両方のミューテーション合計で 1 秒あたり 20 リクエスト
jobsIngest.clearSourcedJobPostingUpdates ミューテーション

関連情報:

• RFC 6585: Additional HTTP Status Codes - 429 Too Many Requests
• Rate limiting (Indeed PLUS)

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

GraphQL にアクセスする前に発生する OAuth エラーのトラブルシューティングについては、OAuth エラーをトラブルシューティングする をご覧ください。

GraphQL エラーをトラブルシューティングするには、GraphQL エラーをトラブルシューティングする をご覧ください。

次のエラーが発生することがあります。

• FORBIDDEN: Advertiser is in a restricted moderation status
• FORBIDDEN: You are missing permissions for this action
• FORBIDDEN: Advertiser is requesting an update to EJ
• UNAUTHENTICATED
• BAD_USER_INPUT
• NOT_FOUND
• DOWNSTREAM_SERVICE_ERROR or INTERNAL_SERVER_ERROR

FORBIDDEN: Advertiser is in a restricted moderation status

エラーメッセージの例

{
  "errors": [
    {
      "extensions": {
        "code": "FORBIDDEN",
        "message": "Advertiser is in a restricted moderation status"
      }
    }
  ]
}

意味

スパム対策として、Indeed が OAuth トークンに関連付けられた広告主を制限しています。

対処方法

このエラーが発生する可能性は低いですが、発生した場合はパートナーマネージャーに連絡して制限の解除を依頼します。

FORBIDDEN: You are missing permissions for this action

エラーメッセージの例

{
  "errors": [
    {
      "extensions": {
        "code": "FORBIDDEN",
        "message": "You are missing permissions for this action. Ask your administrator for the permissions [Hosted_Job Create, Hosted_Job Update, Hosted_Job Read]"
      }
    }
  ]
}

意味

OAuth トークンに関連付けられたユーザーには、求人を更新する権限がありません。

対処方法

管理者ユーザーが OAuth クライアントを作成していない場合は、OAuth クライアントに関連付けられたユーザーに求人管理権限を付与します。任意の管理者ユーザーが UI でこの権限を付与できます。Indeed account settings をご覧ください。

FORBIDDEN: Advertiser is requesting an update to EJ

エラーメッセージの例

{
  "errors": [
    {
      "extensions": {
        "code": "FORBIDDEN",
        "message": "Advertiser is requesting an update to EJ (id=<EJID>), but the job is claimed by a different advertiser."
      }
    }
  ]
}

意味

別の広告主がすでにこの求人を更新しているため、この広告主は更新できません。1 件の求人を同時に更新できる広告主は 1 社だけです。

正しい広告主に対して OAuth トークンをリクエストしたことを確認します。

対処方法

別の広告主がその求人を更新している場合、その広告主の更新がクリアされるまでこのエラーは継続します。求人の更新をクリアする ミューテーションをご覧ください。

この状況は、次のいずれかの理由で発生することがあります。

• 代理店が 2 つ以上の広告主を通じてその求人にアクセスできる場合。

  代理店が 1 つの広告主を通じてその求人を更新した後、別の広告主を通じて同じ求人を更新しようとすると、このエラーが発生します。

• 雇用主が UI でその求人を編集した場合。

  代理店が API を通じてその求人を更新する前に、雇用主は UI でその編集を削除する必要があります。

UNAUTHENTICATED

エラーメッセージの例

"extensions.code": "UNAUTHENTICATED"

意味

Indeed はリクエストを認証できません。OAuth トークンの有効期限が切れているか、形式が正しくありません。

対処方法

OAuth エラーをトラブルシューティングする をご覧ください。

BAD_USER_INPUT

エラーメッセージの例

"extensions.code": "BAD_USER_INPUT" 

意味

リクエストに不正な入力が含まれています。詳細は message フィールドをご確認ください。

対処方法

形式が正しくないリクエストフィールドを修正します。

正しい形式のリクエスト例については、次の API リファレンスをご覧ください。

• findEmployerJobsPartner
• updateSourcedJobPostings
• clearSourcedJobPostingUpdates

NOT_FOUND

エラーメッセージの例

"extensions.code": "NOT_FOUND"

意味

Indeed がその求人を見つけられません。

対処方法

sourcedPostingId が正しいことと、正しい広告主に対して OAuth トークンをリクエストしたことを確認します。リクエスト元の広告主にその求人を表示する権限がない場合にも、このエラーが発生します。

DOWNSTREAM_SERVICE_ERROR or INTERNAL_SERVER_ERROR

エラーメッセージの例

"extensions.code": "DOWNSTREAM_SERVICE_ERROR"

または:

"extensions.code": "INTERNAL_SERVER_ERROR"

意味

内部サーバーエラーが発生しました。

対処方法

しばらくしてからリクエストを再試行します。エラーが続く場合は、パートナーマネージャーにお問い合わせください。

 

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