Job Update APIのワークフロー
Job Update APIリファレンス
認証
求人投稿を更新する
ワークフロー
リクエスト – 求人投稿を更新する
更新を確認する
部分的な更新
レスポンス – 求人投稿を更新する
求人投稿情報を取得するクエリ方法を選択する
IDで求人投稿のステータスを取得する
認証
1件の求人クエリ（node）
バッチ求人クエリ（nodes）
Webhookとの連携
条件で求人投稿を一覧表示する
求人投稿の更新をクリアする
ワークフロー
リクエスト – 求人投稿の更新をクリアする
レスポンス – 求人投稿の更新をクリアする
求人ステータス
オーガニックの非スポンサー求人
スポンサー求人
レート制限
エラーのトラブルシューティング
FORBIDDEN：広告主が制限付きモデレーションステータスにある
FORBIDDEN：この操作に必要な権限がありません
FORBIDDEN：広告主がEJの更新を要求している
UNAUTHENTICATED
BAD_USER_INPUT
NOT_FOUND
DOWNSTREAM_SERVICE_ERRORまたはINTERNAL_SERVER_ERROR

Job Update APIガイド

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

法的注意

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

Job Update APIのワークフロー

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

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

Job Update APIリファレンス

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

注記

ATSが求人投稿の作成と有効期限を制御します。

認証

Indeedパートナーになると、Indeedが連携用のアプリを作成します。Partner Consoleにログインして、アプリとOAuth認証情報（クライアントID、クライアントシークレット、および3-legged OAuthの場合は認可コード）を確認します。認証情報をアクセストークンと交換し、API呼び出しを認証します。

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

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

OAuthトークンタイプ
トークンタイプ	説明
広告主を指定した2-legged OAuth トークン	クライアントクレデンシャルグラントタイプ（2-legged OAuth）でSponsored Jobs APIを利用している広告代理店の場合、すでにこのトークンタイプをお持ちです。
3-legged OAuthトークン	すでに3-legged OAuthトークンをお持ちの場合は、代替として使用できます。

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

employer_access
employer.hosted_job

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

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

求人投稿を更新する

注記

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

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

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

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

ワークフロー

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

ワークフロー – 求人投稿を更新する
#	説明	参照
1.	オンボーディングするクライアントを選択する：Indeedにお問い合わせください。
2.	条件で求人投稿を一覧表示する： `findEmployerJobsPartner`を呼び出します。レスポンスで、`JobPostSurfaceStatus.isRejected`が`false`の求人投稿を見つけます。これらはIndeedで検索可能な求人です。後続の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秒以内に反映されますが、保証されません。 `node`クエリ（`id`に`EmployerJob.id`を設定）：1件の求人を取得して変更を確認します。 `nodes`クエリ（`ids`に`EmployerJob.id`の配列を設定）：求人を一括でクエリします。キャンペーンのスポンサー求人を一覧表示するキャンペーンのスポンサー求人を一覧表示するには、`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 will 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は、UpdateSourcedJobPostingsInput型のinputという1つの引数を受け取ります。

inputには、UpdateSourcedJobPostingInputオブジェクトの配列であるupdatesという1つのフィールドがあります。各UpdateSourcedJobPostingInputオブジェクトは、特定の求人投稿に対して行う更新を表します。

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

リクエスト – 求人投稿を更新する
フィールド	タイプ	説明
`sourcedPostingId`	`ID!`	必須。各求人投稿について、次のいずれかを指定します。 `SourcedJobPosting.sourcedPostingId`。`jobsIngest.createSourcedJobPostings`を呼び出した際に返されます（求人投稿を作成するをご覧ください）。 `EmployerJob.id`。`findEmployerJobsPartner`が返します（求人投稿を一覧表示するをご覧ください）。
`metadata.url`	`WebUrl`	広告代理店が提供するURL。求職者がIndeed Apply経由で応募できない場合に、この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）。上限はバイト単位です。マルチバイト文字はバイト数に含まれます。サポートされているタグについては、求人説明の書式をご覧ください。変更しない場合は省略するかnullに設定します。
`body.descriptionFormatting`	`DescriptionFormatting`	求人説明の形式。HTML書式を有効にするには`HTML`に設定します。デフォルト：`TEXT`。
`body.jobLocation` `.general.cityRegionPostal`	`String!`	勤務地を更新する場合は必須。求人の市区町村と都道府県、州、郡などの行政区分、および郵便番号。リモート求人にこのフィールドを設定すると、その求人は地域別リモート求人とみなされます。
`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回のリクエストで複数のフィールドを更新すると、まれに求人投稿に部分的な更新が行われる場合があります。部分的な更新には常にレスポンスにエラーが伴いますが、レスポンスにエラーがあるからといって、必ず部分的な更新が発生したとは限りません。複数フィールドの更新リクエストでエラーが返された場合、更新された求人投稿を表示することで、どのフィールドが正常に更新されたかを確認できます。エラーへの対応については、GraphQLエラーのトラブルシューティングをご覧ください。

レスポンス – 求人投稿を更新する

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

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

sourcedPostingId：求人投稿のユニバーサル一意識別子（UUID）。作成時にIndeedが求人投稿用に生成したSourcedJobPosting.sourcedPostingIdと同じです。この値を使用して、求人投稿を有効期限切れにしたり更新したりします。
employerJobId：求人投稿のIndeedリソース識別子（IRI）。求人投稿のEmployerJob.idと同じです。

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

求人投稿情報を取得するには、次のいずれかのメソッドを使用します（すべてのメソッドが有効です）。

求人投稿情報を取得するクエリ方法を選択する
メソッド	説明
IDで求人投稿のステータスを取得する（`node`または`nodes`クエリ）	求人IRI（`EmployerJob` ID）による直接検索。求人IRIがある場合は、`findEmployerJobsPartner`よりも高速です。ユースケース：求人投稿を更新し変更を確認する：`updateSourcedJobPostings`を呼び出して求人IRI（`EmployerJob` ID）を取得します。`node`クエリで更新を確認します。 Webhook：Webhookを受信し、ペイロードの求人IRIを使用して`node`クエリで現在の求人状態を取得します。
条件で求人投稿を一覧表示する（`findEmployerJobsPartner`）	検索ベース。すべての求人を一覧表示します。一括カタログ取得に使用します。ユースケース：インベントリの同期：IRIがない場合に、定期的にインベントリを同期します。関連するすべての求人を一括取得するには`findEmployerJobsPartner`を呼び出します（`legacySourceId`と`feedType`フィルターのみ利用可能）。

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

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

認証

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

employer_access
employer.hosted_job

1件の求人クエリ（node）

Relay Nodeパターンを使用して、IRI（EmployerJob ID）で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）

IRI（EmployerJob ID）で複数の求人のステータスを取得します。

複数の求人更新の確認や、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エラーコードをご覧ください。

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

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

雇用主の求人投稿を一覧表示するには、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` 注記クライアントの求人がウェブクロールで取得されているか、Indeedでホストされている場合（シナリオ2）は、適切な`jobFeedType`フィルターを指定する必要があります。デフォルトでは、`findEmployerJobsPartner`は連携（XMLまたはAPIフィード）からの求人のみを返します。詳細については、シナリオ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.	条件で求人投稿を一覧表示する： `legacySourceId`を求人投稿更新操作で返された`sourcedPostingId`に設定して、`findEmployerJobsPartner`を呼び出します。	条件で求人投稿を一覧表示する `findEmployerJobsPartner` `legacySourceId` `sourcedPostingId`
3.	求人投稿の更新をクリアする：求人投稿の更新されたフィールドをクリアします。`clearSourcedJobPostingUpdates`を呼び出します。求人投稿の更新をクリアすると、すべての更新されたフィールドがその求人投稿の最新のATSデータに戻ります。	求人投稿の更新をクリアする `clearSourcedJobPostingUpdates`
4.	条件で求人投稿を一覧表示する： `legacySourceId`を求人投稿更新操作で返された`sourcedPostingId`に設定して、`findEmployerJobsPartner`を呼び出します。	条件で求人投稿を一覧表示する `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は、ClearSourcedJobPostingUpdatesInput型のinputという1つの引数を受け取ります。

inputには、ClearSourcedJobPostingUpdateInputオブジェクトの配列であるupdatesという1つのフィールドがあります。各ClearSourcedJobPostingUpdateInputオブジェクトは、更新をクリアする求人投稿を表します。

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

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

リクエスト - 求人投稿の更新をクリアする
フィールド	タイプ	説明
`sourcedPostingId`	`ID!`	必須。各求人投稿について、次のいずれかを指定します。 `SourcedJobPosting.sourcedPostingId`。`jobsIngest.createSourcedJobPostings`を呼び出した際に返されます。求人投稿を作成するをご覧ください。 `EmployerJob.id`。`findEmployerJobsPartner`が返します。条件で求人投稿を一覧表示するをご覧ください。

レスポンス – 求人投稿の更新をクリアする

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

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

sourcedPostingId：求人投稿のユニバーサル一意識別子（UUID）。この値は、作成時にIndeedが求人投稿用に生成したSourcedJobPosting.sourcedPostingIdと同じです。この値を使用して、求人投稿を有効期限切れにしたり更新したりします。
employerJobId：求人投稿のIndeedリソース識別子（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`フィールドを追加する	求人がオーガニックトラフィックかスポンサートラフィックか、Indeed Applyを使用しているかに関係なく、求人へのクリックごとにHTTPリクエストを受信するには、求人にこのフィールドを追加します。求人がオーガニックトラフィックかスポンサートラフィックかは問いません。求人がIndeed Applyを使用しているかは問いません。 `UpdateSourcedJobPostingMetadataInput`入力オブジェクトの`trackingUrl`をご覧ください。
2.	カスタム求人URLを使用する	求人URLをご自身が所有するキャリアページに置き換えるか、ATSパートナーと連携してトラッキングメタデータを求人URLに付加します。求人にIndeed Applyがない場合、求職者はこのURLに遷移します。求人にIndeed Applyがある場合、求職者はこの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分間に分散させてください。

レート制限を超えると、HTTP 429ステータスコードがHTTPレベルまたはGraphQLリクエストへのJSONレスポンスのerrors配列で返されます。

対応は不要です。これらのレート制限の回避にサポートが必要な場合は、サポートをリクエストしてください。

これらのレート制限を超えると通知されます。

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

エラーのトラブルシューティング

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

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

次のエラーが発生する可能性があります。

FORBIDDEN：広告主が制限付きモデレーションステータスにある
FORBIDDEN：この操作に必要な権限がありません
FORBIDDEN：広告主がEJの更新を要求している
UNAUTHENTICATED
BAD_USER_INPUT
NOT_FOUND
DOWNSTREAM_SERVICE_ERRORまたはINTERNAL_SERVER_ERROR

FORBIDDEN：広告主が制限付きモデレーションステータスにある

エラーメッセージの例

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

意味

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

対処方法

このエラーはほとんど発生しません。発生した場合は、制限を解除するためにパートナーマネージャーにお問い合わせください。

FORBIDDEN：この操作に必要な権限がありません

エラーメッセージの例

{
  "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アカウント設定をご覧ください。

FORBIDDEN：広告主が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トークンが正しい広告主でリクエストされたことを確認してください。

対処方法

別の広告主が求人を更新した場合、他の広告主による更新がクリアされるまでこのエラーが発生します。求人投稿の更新をクリアするミューテーションをご覧ください。

この状況は、次のいずれかの理由で発生します。

広告代理店が複数の広告主から同じ求人へのアクセス権を持っている。

広告代理店がある広告主から求人を更新した後、別の広告主から求人を更新しようとすると、このエラーが発生します。
雇用主がUIで求人を編集した。

広告代理店がAPIで求人を更新する前に、雇用主がUIでこれらの編集を取り消す必要があります。

UNAUTHENTICATED

エラーメッセージの例

"extensions.code": "UNAUTHENTICATED"

意味

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

対処方法

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

BAD_USER_INPUT

エラーメッセージの例

"extensions.code": "BAD_USER_INPUT" 

意味

リクエストの形式に問題があります。詳細についてはmessageフィールドをご覧ください。

対処方法

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

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

NOT_FOUND

エラーメッセージの例

"extensions.code": "NOT_FOUND"

意味

求人が見つかりません。

対処方法

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

DOWNSTREAM_SERVICE_ERRORまたはINTERNAL_SERVER_ERROR

エラーメッセージの例

"extensions.code": "DOWNSTREAM_SERVICE_ERROR"

または：

"extensions.code": "INTERNAL_SERVER_ERROR"

意味

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

対処方法

後でリクエストを再試行してください。エラーが解決しない場合は、パートナーマネージャーにお問い合わせください。

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

このページの内容

Job Update APIのワークフロー
- Job Update APIリファレンス
認証
求人投稿を更新する
求人投稿情報を取得するクエリ方法を選択する
IDで求人投稿のステータスを取得する
条件で求人投稿を一覧表示する
求人投稿の更新をクリアする
求人ステータス
- オーガニックの非スポンサー求人
- スポンサー求人
レート制限
エラーのトラブルシューティング

On this page

Job Update APIのワークフロー​

Job Update APIリファレンス​

認証​

求人投稿を更新する​

ワークフロー​

リクエスト – 求人投稿を更新する​

更新を確認する​

部分的な更新​

レスポンス – 求人投稿を更新する​

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

IDで求人投稿のステータスを取得する​

認証​

1件の求人クエリ（node）​

バッチ求人クエリ（nodes）​

Webhookとの連携​

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

リクエスト – 条件で求人投稿を一覧表示する​

レスポンス – 条件で求人投稿を一覧表示する​

求人投稿の更新をクリアする​

ワークフロー​

リクエスト – 求人投稿の更新をクリアする​

レスポンス – 求人投稿の更新をクリアする​

求人ステータス​

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

スポンサー求人​

レート制限​

エラーのトラブルシューティング​

FORBIDDEN：広告主が制限付きモデレーションステータスにある​

エラーメッセージの例​

意味​

対処方法​

FORBIDDEN：この操作に必要な権限がありません​

エラーメッセージの例​

意味​

対処方法​

FORBIDDEN：広告主がEJの更新を要求している​

エラーメッセージの例​

意味​

対処方法​

UNAUTHENTICATED​

エラーメッセージの例​

意味​

対処方法​

BAD_USER_INPUT​

エラーメッセージの例​

意味​

対処方法​

NOT_FOUND​

エラーメッセージの例​

意味​

対処方法​

DOWNSTREAM_SERVICE_ERRORまたはINTERNAL_SERVER_ERROR​

エラーメッセージの例​

意味​

対処方法​

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

このページの内容

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

Job Update APIのワークフロー

Job Update APIリファレンス

認証

求人投稿を更新する

ワークフロー

リクエスト – 求人投稿を更新する

更新を確認する

部分的な更新

レスポンス – 求人投稿を更新する

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

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

認証

1件の求人クエリ（node）

バッチ求人クエリ（nodes）

Webhookとの連携

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

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

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

求人投稿の更新をクリアする

ワークフロー

リクエスト – 求人投稿の更新をクリアする

レスポンス – 求人投稿の更新をクリアする

求人ステータス

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

スポンサー求人

レート制限

エラーのトラブルシューティング

FORBIDDEN：広告主が制限付きモデレーションステータスにある

エラーメッセージの例

意味

対処方法

FORBIDDEN：この操作に必要な権限がありません

エラーメッセージの例

意味

対処方法

FORBIDDEN：広告主がEJの更新を要求している

エラーメッセージの例

意味

対処方法

UNAUTHENTICATED

エラーメッセージの例

意味

対処方法

BAD_USER_INPUT

エラーメッセージの例

意味

対処方法

NOT_FOUND

エラーメッセージの例

意味

対処方法

DOWNSTREAM_SERVICE_ERRORまたはINTERNAL_SERVER_ERROR

エラーメッセージの例

意味

対処方法