Job Update API ガイド

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

 

法的注意

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

Job Update 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 がある場合は、node クエリまたは nodes クエリを使用します。
6. 6.
   条件で求人を一覧表示する - 一括取得には、findEmployerJobsPartner を使用します。
7. 7.
   求人の更新をクリアする - clearSourcedJobPostingUpdates を使用して更新を削除します。
8. 8.
   求人ステータスを確認する。
9. 9.
   レート制限を確認する。
10. 10.
    GraphQL エラーをトラブルシューティングする。

Job Update API リファレンス

• updateSourcedJobPostings - サポートされている求人フィールドを更新します。
• node - ID で 1 件の求人を取得します。
• 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 token	すでに Sponsored Jobs API を client credentials grant type (2-legged OAuth) で使用している場合は、このトークンタイプをすでにお持ちの可能性があります。
3-legged OAuth token	すでに 3-legged OAuth トークンをお持ちの場合は、それを使用できます。

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

• employer_access
• employer.hosted_job

スコープの詳細については、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 で検索可能です。後続の API 呼び出しのために EmployerJob.id を保存します。	条件で求人を一覧表示する findEmployerJobsPartner の API リファレンス JobPostSurfaceStatus.isRejected EmployerJob.id
3.	求人を更新する: トラッキング URL や求人 URL などのフィールドを更新するには、updateSourcedJobPostings を呼び出します。フィールドを更新すると、その後の ATS からのそのフィールドへの変更は、求職者に表示されなくなります。サポートされているフィールドについては、UpdateSourcedJobPostingMetadataInput と UpdateSourcedJobPostingBodyInput をご覧ください。	求人を更新する updateSourcedJobPostings の API リファレンス sourcedPostingId EmployerJob.id UpdateSourcedJobPostingMetadataInput UpdateSourcedJobPostingBodyInput
4.	更新を確認する: 次のいずれかの方法を使用します。 findEmployerJobsPartner: アクセストークンごとにこの操作を呼び出せるのは、1 時間に 1 回までです。更新は通常 30 秒以内に反映されますが、Indeed は時刻を保証しません。 node クエリ: EmployerJob.id で 1 件の求人を取得して、変更を確認します。 nodes クエリ: EmployerJob.id の値を使って、1 回の呼び出しで複数の求人を取得します。 キャンペーンのスポンサー求人を一覧表示するには、campaignCategories を ad_campaign_category:{category} に設定します。たとえば、ad_campaign_category:foo は foo キャンペーンのスポンサー求人を返します。	findEmployerJobsPartner の API リファレンス node nodes EmployerJob.id campaignCategories

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

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

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

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

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

• 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 は、型 UpdateSourcedJobPostingsInput の引数 input を 1 つ受け取ります。

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

各 UpdateSourcedJobPostingInput オブジェクトでは、次のフィールドをサポートしています。

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

フィールド	型	説明
sourcedPostingId	ID!	必須。 各求人について、次のいずれかの値を指定します。 SourcedJobPosting.sourcedPostingId。これは jobsIngest.createSourcedJobPostings から返されます。求人を作成する をご覧ください。 EmployerJob.id。これは findEmployerJobsPartner から返されます。条件で求人を一覧表示する をご覧ください。
metadata.url	WebUrl	Indeed Apply を利用できない場合に、求職者が応募できる広告代理店の URL です。
metadata.campaignCategories	[String!]	キャンペーン選定のために関連する求人をグループ化するカテゴリタグです。指定した値に対して、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 の場合、1000 は 10 ドルを意味します。現在の値をクリアするには、このフィールドを省略するか null に設定します。
body.salary.minimumMinor	Int64	現地通貨の最小単位で表した給与下限です。USD の場合、1000 は 10 ドルを意味します。現在の値をクリアするには、このフィールドを省略するか null に設定します。
body.salary.period	JobSalaryPeriod!	給与を更新する場合は必須です。 時給、日給、週給など、給与の計算に使用する単位です。
body.companyName	String	求人の会社名を更新します。変更しない場合は、このフィールドを省略するか null に設定します。最大長は 200 文字です。

詳細については、API リファレンス をご覧ください。

更新を確認する

updateSourcedJobPostings のレスポンスには求人 IRI が含まれます。変更を確認するには、返された IRI に対して node クエリを使用します。

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

部分更新

フィールドの更新はアトミックではありません。1 回のリクエストで複数のフィールドを更新すると、API がまれに一部の変更だけを適用することがあります。その場合、レスポンスにはエラーが含まれます。

エラーレスポンスが返っても、必ずしも部分更新が発生したとは限りません。複数フィールドのリクエストでエラーが返された場合は、更新済みの求人を表示して、どのフィールドが成功したかを確認してください。エラー処理のガイダンスについては、GraphQL エラーをトラブルシューティングする をご覧ください。

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

updateSourcedJobPostings は UpdateSourcedJobPostingsPayload オブジェクトを返します。これには、UpdateSourcedJobPostingResult オブジェクトの配列である results フィールドが含まれます。各オブジェクトは、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 を呼び出して求人 IRI を取得し、その後 node を使って変更を確認します。 Webhook の処理: webhook を受信した後、ペイロード内の求人 IRI を使って node を呼び出し、現在の求人状態を取得します。
条件で求人を一覧表示する（findEmployerJobsPartner）	この検索ベースの方法は、すべての求人を一覧表示する場合に使用します。一括で求人在庫を取得する用途に最適です。 使用例: 在庫同期: IRI を持っていない場合は、findEmployerJobsPartner を呼び出して、関連付けられた求人を一括取得します。利用できるフィルターは legacySourceId と feedType だけです。

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

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

認証

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

• 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)

複数の求人について、その 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 をご覧ください。

webhooks を扱う

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: 求人の並び替えに使用するフィールドを定義します。このフィールドを省略すると、sortDirection は効果を持ちません。
first	返す求人件数です。 デフォルト: 10 最大: 500
before	この値より前のカーソル値を持つ項目を返します。ページネーションの詳細については、レスポンスの PageInfo を使用してください。
after	この値より後のカーソル値を持つ項目を返します。ページネーションの詳細については、レスポンスの PageInfo を使用してください。

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

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

リクエストにフィルターや並び替えを含めると、API は結果にそれらを適用します。

トークンで想定した求人が返らない場合は、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 は、update-job-posting 操作から返される sourcedPostingId です。	条件で求人を一覧表示する findEmployerJobsPartner の API リファレンス legacySourceId sourcedPostingId
3.	求人の更新をクリアする: 更新済みのフィールドをクリアするには、clearSourcedJobPostingUpdates を呼び出します。すると、その求人は最新の ATS データに戻ります。	求人の更新をクリアする clearSourcedJobPostingUpdates の API リファレンス
4.	条件で求人を一覧表示する: 同じ legacySourceId で findEmployerJobsPartner を再度呼び出します。	条件で求人を一覧表示する findEmployerJobsPartner の API リファレンス legacySourceId sourcedPostingId

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

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

updateSourcedJobPostings が以前に変更したフィールドをクリアするには、jobsIngest.clearSourcedJobPostingUpdates ミューテーションを呼び出します。

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

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

• 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 つあります。各オブジェクトは、更新をクリアしたい 1 件の求人を識別します。

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

各 ClearSourcedJobPostingUpdateInput オブジェクトでは、次のフィールドをサポートしています。

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

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

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

clearSourcedJobPostingUpdates は ClearSourcedJobPostingUpdatesPayload オブジェクトを返します。これには、ClearSourcedJobPostingUpdateResult オブジェクトの配列である results フィールドが含まれます。各オブジェクトは、更新がクリアされた 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 Apply を使用しているかどうか。 UpdateSourcedJobPostingMetadataInput の trackingUrl をご覧ください。
2.	カスタム求人 URL を使用する	求人 URL を自社で所有する採用ページに置き換えるか、ATS パートナーと連携して求人 URL にトラッキングメタデータを追加します。 求人が Indeed Apply を使用していない場合、求職者はこの URL に移動します。Indeed Apply を使用している場合は、移動しません。 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 は通常の 1 日あたりの Job Update 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 トークンをリクエストしたことを確認してください。

対処方法

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

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

• 代理店が、複数の広告主を通じてその求人にアクセスできる。

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

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

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

UNAUTHENTICATED

エラーメッセージの例

"extensions.code": "UNAUTHENTICATED"

意味

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

対処方法

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

BAD_USER_INPUT

エラーメッセージの例

"extensions.code": "BAD_USER_INPUT"

意味

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

対処方法

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

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

• 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"

意味

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

対処方法

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

 

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