前提条件
OAuthを設定する
OAuth v2トークンスコープ
OAuthアクセストークンを取得する
キャンペーン管理のハウツーガイド
キャンペーン予算見積もりを取得する
単発キャンペーンを作成する
目標ベースのキャンペーンを作成する
定期キャンペーンを作成する
定期キャンペーン情報を更新する
キャンペーン予算を更新する
キャンペーン期間を更新する
キャンペーン内の求人の詳細を取得する
レポートのハウツーガイド
キャンペーンパフォーマンスをレポートする
アカウント管理の手順ガイド
採用企業アカウント情報を取得する
サブアカウント情報を取得する
サブアカウントを作成する
アカウント予算を取得する
アカウント予算を設定する
APIクォータ使用状況の手順ガイド
広告主の API クォータ使用状況を取得する
推奨事項とガイドライン
結果整合性に備える
API変更との互換性を確保する
FAQとトラブルシューティング
FAQ
よくあるエラーをトラブルシューティングする
OAuthエラーをトラブルシューティングする

Sponsored Jobs API スタートガイド

Sponsored Jobs APIを使い始めます。

法的注意

Indeed の API の使用について Indeed と書面による契約を締結していない場合、この API またはそのドキュメントを使用することにより、Indeed の API の使用には Indeed API Terms および Additional API Terms and Guidelines が適用されることに同意したものとみなされます。

2026年1月8日:
- 2026年2月1日より、Indeed は EU 諸国およびスイスのすべてのユーザーに対して、Indeed Sponsored Jobs API の使用ポリシーを適用します。対象国は、AT、BE、CH、DE、DK、EE、ES、FI、FR、GR、IE、IT、LU、NL、PL、PT、RO、および SE です。
  Indeed は、Sponsored Jobs API の呼び出し 1 回ごとに 3 EUR、または広告主が選択した請求通貨での同等額を請求します。Indeed は、月間のキャンペーンスポンサーシップ支出額が月間の API 呼び出し総費用を下回る場合にのみ課金します。
- 2026年2月1日より、Indeed は AR、AU、BR、CA、CL、CO、CR、GB、ID、IN、MX、MY、NZ、PA、PH、SG、および TH のすべてのユーザーに対して、Indeed Sponsored Jobs API の使用ポリシーを適用します。
  Indeed は、Sponsored Jobs API の呼び出し 1 回ごとに 3 USD、または広告主が選択した請求通貨での同等額を請求します。Indeed は、月間のキャンペーンスポンサーシップ支出額が月間の API 呼び出し総費用を下回る場合にのみ課金します。
  このポリシーでは、Sponsored Jobs API のお客様に対して、スポンサーシップ支出額に基づく API 使用料の支払いを求めます。このポリシーは、Indeed 独自の ATS プラグインを使用するお客様には適用されません。
  推奨される使用パターンについては、Sponsored Jobs API best practices to reduce call volume をご覧ください。
  Sponsored Jobs API を使用できるのは、過去 3 暦月以内にキャンペーンを通じてスポンサー求人を掲載した有料のお客様のみです。
  Indeed は、暦月ごとの Sponsored Jobs API の使用回数に上限を設けています。この上限は、前月の Sponsored Jobs キャンペーン支出額とクレジット上限額のいずれか大きい方に等しくなります。
  /apiquotausage エンドポイントを呼び出して、当月の API 使用状況を取得します。
2026年1月8日:
- 2024年12月1日より、Indeed は米国において Indeed Sponsored Jobs API の使用ポリシーを適用します。
  このポリシーでは、Indeed Sponsored Jobs API のお客様に対して、スポンサーシップ支出額に基づく API 使用料の支払いを求めます。
  このポリシーは、Indeed 独自の ATS プラグインを使用するお客様には適用されません。
  推奨される API 使用パターンについては、Sponsored Jobs API best practices to reduce call volume をご覧ください。
2024-06-30 より有効：GET /v1/stats/datastatus エンドポイントは廃止され、HTTP 404 を返します。代わりに GET /v1/stats を使用してください。
2024-06-26 より有効：GET /v1/campaigns/:campaignId/stats/:date および GET /v1/campaigns/:campaignId/stats/entryDates エンドポイントは廃止され、HTTP 404 を返します。

代わりに GET /v1/campaigns/{campaignId}/stats を使用してください。
2024-06-26 より有効：GET /v1/campaigns の perPage パラメータは 500 が上限となります。これより大きい値を指定したリクエストは、無効として拒否されます。
Sponsored Jobs レガシー API の廃止：
- 2021-08-01：Indeed OAuth v2 エンドポイントを使用し、可用性が高く低レイテンシのインフラストラクチャで動作する、最新の Sponsored Jobs API ゲートウェイへ移行してください。
- 2022-01-01：Sponsored Jobs レガシー API が廃止されました。
- 2022-03-31：Sponsored Jobs XML 連携が廃止されました。

前提条件、例付きのハウツーガイド、FAQ、トラブルシューティングを確認してください。

前提条件

OAuthを設定する

Sponsored Jobs APIを使用する前に、次のものが必要です。

Indeedアカウント
APIクライアントIDとシークレット
Indeedアカウント内でスポンサーできる求人
アカウントに関連付けられた採用企業

Sponsored Jobs APIのOAuth
OAuth	説明
2-legged OAuth	このガイドの例では、クライアントクレデンシャルフロー（2-legged OAuth）を使用しています。直接採用企業、代理店、またはプログラマティックの場合は、このOAuthフローを使用してください。採用企業に代わって動作する代理店およびプログラマティックの場合、Indeedは採用企業がIndeedアカウントをセカンダリユーザーとして追加することを推奨します。これにより、クライアントクレデンシャルフロー（2-legged OAuth）を使用できます。 2-legged OAuthアプリを登録してクライアントIDとシークレットを取得します。 Partner Consoleを使用します。コンソールにアクセスできない場合は、Indeed担当者または marketplacesupport@indeed.com にお問い合わせください。
3-legged OAuth	ATSパートナーは認可コードフロー（3-legged OAuth）を使用する必要があります。 Indeed パートナーになると、Indeed が連携用のアプリを作成します。Partner Console にサインインして、アプリと OAuth 認証情報（クライアント ID、クライアントシークレット、および 3-legged OAuth の場合は認可コード）を確認します。認証情報をアクセストークンと交換し、API 呼び出しを認証します。

OAuth v2トークンスコープ

アクセストークンを取得するときは、少なくとも 1 つのスコープをリクエストする必要があります。

書き込みスコープには、対応する読み取り専用スコープが含まれます。たとえば、employer.advertising.campaign には employer.advertising.campaign.read も含まれます。
1 つのアクセストークンに複数のスコープをリクエストできます。用語集をご覧ください。スコープはスペースで区切って指定します。例: employer_access employer.advertising.campaign employer.advertising.campaign_report.read

OAuth 認可コードリクエストでは、呼び出す API エンドポイントに必要なスコープを含めます。エンドユーザーは、そのスコープの一部、すべて、またはどれも付与しないことができます。用語集をご覧ください。

OAuthアクセストークンを取得する

oauth/v2/tokens APIエンドポイントを呼び出してアクセストークンを取得するには、必要なトークンを呼び出すAPIに合わせて更新します。

Sponsored Jobs APIのほとんどのエンドポイントは、採用企業を表すアクセストークンを必要とします。そのため、呼び出す予定のエンドポイントで必要なスコープに加えてemployer_accessスコープをリクエストし、アクセスする採用企業を指定するemployerパラメータを含めます。ただし、マスターアカウントを持っていてサブアカウント管理エンドポイントを呼び出す場合は、アクセストークンをリクエストする際にemployerパラメータを省略します。サブアカウント管理エンドポイントは次のいずれかで呼び出します。

GET /v1/subaccounts
POST /v1/subaccounts

tokensエンドポイントのAPI詳細

tokensエンドポイント
API URL	`https://apis.indeed.com/oauth/v2/tokens`
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	なし

tokensエンドポイントのリクエストパラメータ

tokensリクエストパラメータ
キー	値
`client_id`	クライアントID。次から取得します。 * 日本のみ: アプリ認証情報の管理。詳細については、認証情報を参照してください。 * 日本以外: Partner Console。コンソールにアクセスできない場合は、Indeed担当者または marketplacesupport@indeed.com にお問い合わせください。
`client_secret`	クライアントシークレット。次から取得します。 * 日本のみ: アプリ認証情報の管理。詳細については、認証情報を参照してください。 * 日本以外: Partner Console。コンソールにアクセスできない場合は、Indeed担当者または marketplacesupport@indeed.com にお問い合わせください。
`grant_type`	`client_credentials`。
`scope`	エンドポイントに依存します。例: `employer_access employer.advertising.account.read`。
`employer`	採用企業アカウントID。

tokensエンドポイントのレスポンス例

{
  "access_token": "<access_token>",
  "scope": "employer.advertising.account.read employer_access",
  "token_type": "Bearer",
  "expires_in": 3600
}

キャンペーン管理のハウツーガイド

キャンペーン予算見積もりを取得する

この手順では、キャンペーン作成前に求人ごとの推奨日次予算とキャンペーン全体の平均日次予算を取得します。

単発キャンペーンを作成する

この例では、2週間実行される単発キャンペーンを作成し、$500の予算で2か所の求人をスポンサーします。

単発キャンペーンのスコープを持つアクセストークンを使用します。

単発キャンペーンを作成する
scope employer_access employer.advertising.campaign
求人のジョブソースIDを取得します。

ジョブソースIDを取得するには、採用企業アカウント情報を取得するを参照してください。採用企業はWebサイトやドメインごとに1つずつ、複数のジョブソースIDを持つことができます。jobSourceList.idレスポンスフィールドの値が、各サイトのジョブソースIDです。

単発キャンペーンを作成する
scope	`employer_access employer.advertising.campaign`

単発キャンペーンを作成します。

単発キャンペーンのAPI詳細:

単発キャンペーンのAPI詳細
API URL	`https://apis.indeed.com/ads/v1/campaigns` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

単発キャンペーンのリクエスト例:

{
  "name": "Test Campaign Single-use",
  "status": "PAUSED",
  "trackingToken": "MyTrackingToken",
  "jobsSourceId": "[Your jobsSourceId from Step 2]",
  "jobsToInclude": "QUERY",
  "jobsQuery": "city:Aberdeen OR city:Glasgow",
  "budgetOnetimeLimit": 500,
  "startDate": "2021-09-01",
  "fixedEndDate": "2021-09-15"
}

単発キャンペーンのレスポンス例:

{
  "meta": {
    "status": 201,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
      "rel": "Campaign Info",
      "href": "/v1/campaigns/c8bxxxxxxxxx449"
    }]
  },
  "data": {
    "campaignId": "c8bxxxxxxxxx449"
  }
}

Indeedで単発キャンペーンを表示します。

単発キャンペーンのAPI呼び出し:

キャンペーンを作成するAPI呼び出し

Indeedで作成された単発キャンペーン:

Indeedで作成された単発キャンペーン

目標ベースのキャンペーンを作成する

この例では、特定の予定面接数を目標とする目標ベースのキャンペーンを作成します。

目標ベースのキャンペーンのスコープを持つアクセストークンを使用します。

目標ベースのキャンペーンを作成する
scope employer_access employer.advertising.campaign
目標ベースのキャンペーン用に求人のソースIDを取得します。

ジョブソースIDを取得するには、採用企業アカウント情報を取得するを参照してください。採用企業はWebサイトやドメインごとに1つずつ、複数のジョブソースIDを持つことができます。jobSourceList.idレスポンスフィールドの値が、各サイトのジョブソースIDです。

目標ベースのキャンペーンを作成する
scope	`employer_access employer.advertising.campaign`

面接目標キャンペーンを作成します。

面接目標キャンペーンのAPI詳細:

面接目標キャンペーンを作成する
API URL	`https://apis.indeed.com/ads/v1/campaigns` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

面接目標キャンペーンのリクエスト例:

{
  "name": "XXX SCHEDULED_INTERVIEWS",
  "status": "PAUSED",
  "trackingToken": "indeed_chi",
  "jobsSourceId": "[Your jobsSourceId from Step 2]",
  "jobsToInclude": "ALL",
  "jobsQuery": "Java",
  "jobsTitle": "software engineer",
  "jobsCompany": "Indeed",
  "jobsLocation": "Austin",
  "jobsLocationRadius": 5,
  "fixedEndDate": "2023-10-20",
  "budgetOnetimeLimit": 1000,
  "objective": {
    "objectiveType": "SCHEDULED_INTERVIEWS",
    "target": 77
  }
}

面接目標キャンペーンのレスポンス例:

{
  "meta": {
    "status": 201,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
      "rel": "Campaign Info",
      "href": "/v1/campaigns/f261xxxxxxxx6567"
    }]
  },
  "data": {
    "campaignId": "f261xxxxxxxx6567"
  }
}

Indeedで面接キャンペーンを表示します。

Indeedで作成された面接キャンペーン

Indeedで作成された面接キャンペーンの面接目標設定

定期キャンペーンを作成する

この例では、6か月間実行される定期キャンペーンを作成し、3か所のマネージャー求人を月$1500の予算でスポンサーします。

スコープを持つアクセストークンを使用します。

定期キャンペーンを作成する
scope employer_access employer.advertising.campaign
定期キャンペーン用に求人のソースIDを取得します。

ジョブソースIDを取得するには、採用企業アカウント情報を取得するを参照してください。採用企業はWebサイトやドメインごとに1つずつ、複数のジョブソースIDを持つことができます。jobSourceList.idレスポンスフィールドの値が、各サイトのジョブソースIDです。

定期キャンペーンを作成する
scope	`employer_access employer.advertising.campaign`

定期キャンペーンを作成します。

定期キャンペーンのAPI詳細:

定期キャンペーンを作成する
API URL	`https://apis.indeed.com/ads/v1/campaigns` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

定期キャンペーンのリクエスト例:

{
  "name": "Test Campaign Recurring",
  "status": "PAUSED",
  "trackingToken": "MyTrackingToken",
  "jobsSourceId": "[Your jobsSourceId from Step 2]",
  "jobsToInclude": "QUERY",
  "jobsQuery": "(city:Aberdeen OR city:Glasgow OR city:London) AND title: Manager",
  "budgetMonthlyLimit": 1500,
  "startDate": "2021-09-01",
  "fixedEndDate": "2022-04-01"
}

定期キャンペーンのレスポンス例:

{
  "meta": {
    "status": 201,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
      "rel": "Campaign Info",
      "href": "/v1/campaigns/52fxxxxxxxxx310"
    }]
  },
  "data": {
    "campaignId": "52fxxxxxxxxx310"
  }
}

Indeedで定期キャンペーンを表示します。

定期キャンペーンのAPI呼び出し:

Indeedで作成された定期キャンペーンのAPI呼び出し

Indeedで作成された定期キャンペーン:

Indeedで作成された定期キャンペーン

定期キャンペーン情報を更新する

この例では、キャンペーンを検索して更新し、追加の場所を加えます。このエンドポイントを使用して、キャンペーンの開始や一時停止、名前変更、トラッキングトークンの変更も行えます。詳細については、Sponsored Jobs APIリファレンスを参照してください。

更新用のスコープを持つアクセストークンを使用します。

定期キャンペーンを編集する
scope employer_access employer.advertising.campaign

定期キャンペーンを編集する
scope	`employer_access employer.advertising.campaign`

キャンペーンとそのIDを一覧表示して、定期キャンペーンのキャンペーンIDを取得します。

定期キャンペーン更新のAPI詳細:

定期キャンペーンを更新する
API URL	`https://apis.indeed.com/ads/v1/campaigns` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

定期キャンペーン更新のリクエストパラメータ:

定期キャンペーン更新のリクエストパラメータ
キー	値
`perPage`	10
`status`	PAUSED
`type`	SOURCE

定期キャンペーン更新のレスポンス例:

"meta": {
  "status": 200,
  "errors": null,
  "rootLocation": "https://apis.indeed.com/ads",
  "perPage": 10,
  "links": [{
      "rel": "'Test Campaign Single-use' Info",
      "href": "/v1/campaigns/c8bxxxxxxxxx449"
    },
    {
      "rel": "'Test Campaign Recurring' Info",
      "href": "/v1/campaigns/52fxxxxxxxxx310"
    }
  ]
},
"data": {
  "Campaigns": [{
      "Name": "Test Campaign Single-use",
      "Id": "c8bxxxxxxxxx449",
      "Status": "PAUSED"
    },
    {
      "Name": "Test Campaign Recurring",
      "Id": "52fxxxxxxxxx310",
      "Status": "PAUSED"
    }
  ]
}

キャンペーンクエリを更新します。

jobsQueryフィールドで、インデックス求人クエリ形式を使用してクエリを渡します。

キャンペーンクエリ更新のAPI詳細:

キャンペーンクエリを更新する
API URL	`https://apis.indeed.com/ads/v1/campaigns/<YourCampaignIdFromStep2}` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`PATCH`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

キャンペーンクエリ更新のリクエスト例:

{
  "jobsToInclude": "QUERY",
  "jobsQuery": "(city:Aberdeen OR city:Glasgow OR city:London OR city:Birmingham) AND title: Manager"
}

キャンペーンクエリ更新のレスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
        "rel": "up",
        "href": "/v1/campaigns"
      },
      {
        "rel": "Campaign Info",
        "href": "/v1/campaigns/52fxxxxxxxxx310"
      },
      {
        "rel": "Traffic Statistics",
        "href": "/v1/campaigns/52fxxxxxxxxx310/stats"
      }
    ]
  },
  "data": {
    "campaignId": "52fxxxxxxxxx310"
  }
}

Indeedで更新されたキャンペーンクエリを表示します。

定期キャンペーン更新のAPI呼び出し:

定期キャンペーンを編集するAPI呼び出し

Indeedで更新された定期キャンペーン:

Indeedで更新された定期キャンペーン

キャンペーン予算を更新する

この例では、キャンペーンを検索して更新し、予算を月$250増額（$1500から$1750）します。

キャンペーン予算更新のスコープを持つアクセストークンを使用します。

キャンペーン予算を変更する
scope employer_access employer.advertising.campaign
更新するキャンペーン予算のIDを取得します。

キャンペーンを一覧表示するには、定期キャンペーンのキャンペーンIDを取得するを参照してください。

キャンペーン予算を変更する
scope	`employer_access employer.advertising.campaign`

キャンペーン予算を更新します。

キャンペーン予算更新のAPI詳細:

キャンペーン予算を更新する
API URL	`https://apis.indeed.com/ads/v1/campaigns/{YourCampaignIdFromStep2}/budget` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`PATCH`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

キャンペーン予算更新のリクエスト例:

{
  "budgetMonthlyLimit": "1750"
}

キャンペーン予算更新のレスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
        "rel": "up",
        "href": "/v1/campaigns"
      },
      {
        "rel": "Campaign Info",
        "href": "/v1/campaigns/52fxxxxxxxxx310"
      },
      {
        "rel": "Traffic Statistics",
        "href": "/v1/campaigns/52fxxxxxxxxx310/stats"
      }
    ]
  },
  "data": {
    "campaignId": "52fxxxxxxxxx310"
  }
}

Indeedでキャンペーン予算を表示します。

キャンペーン予算を更新するAPI呼び出し:

キャンペーン予算を更新するAPI呼び出し

キャンペーン予算更新の例:

Indeedで更新されたキャンペーン予算

キャンペーン期間を更新する

この例では、単発キャンペーンの期間を検索して2週間延長します。

キャンペーン期間のスコープを持つアクセストークンを使用します。

キャンペーン期間を変更する
scope employer_access employer.advertising.campaign
キャンペーン期間のIDを取得します。

キャンペーンを一覧表示するには、定期キャンペーンのキャンペーンIDを取得するを参照してください。

キャンペーン期間を変更する
scope	`employer_access employer.advertising.campaign`

キャンペーンの日付を更新します。

キャンペーン期間のAPI詳細:

キャンペーンの日付を更新する
API URL	`https://apis.indeed.com/ads/v1/campaigns/{YourCampaignIdFromStep2}/budget` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`PATCH`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

キャンペーン期間のリクエスト例:

{
  "fixedEndDate": "2021-09-30"
}

キャンペーン期間のレスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
        "rel": "up",
        "href": "/v1/campaigns"
      },
      {
        "rel": "Campaign Info",
        "href": "/v1/campaigns/c8bxxxxxxxxx449"
      },
      {
        "rel": "Traffic Statistics",
        "href": "/v1/campaigns/c8bxxxxxxxxx449/stats"
      }
    ]
  },
  "data": {
    "campaignId": "c8bxxxxxxxxx449"
  }
}

Indeedでキャンペーン期間を表示します。

キャンペーン期間を更新するAPI呼び出し:

キャンペーン期間を更新するAPI呼び出し

キャンペーン終了日更新の例:

Indeedで更新された終了日

キャンペーン内の求人の詳細を取得する

この例では、キャンペーンがスポンサーする求人の詳細情報を取得します。

キャンペーン求人のスコープを持つアクセストークンを使用します。

キャンペーン内の求人を表示する
scope employer_access employer.advertising.campaign
更新するキャンペーンのIDを取得します。キャンペーンを一覧表示するには、定期キャンペーンのキャンペーンIDを取得するを参照してください。

キャンペーン内の求人を表示する
scope	`employer_access employer.advertising.campaign`

キャンペーンがスポンサーする求人の最初のページを取得します。

求人のAPI詳細:

キャンペーンがスポンサーする求人の最初のページを取得する
API URL	`https://apis.indeed.com/ads/v1/campaigns/{YourCampaignIdFromStep2}/jobDetails` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

更新キャンペーンのリクエスト例:

更新キャンペーンのリクエストパラメータ:

更新キャンペーンのリクエストパラメータ
キー	値
`start`	0
`perPage`	3

更新キャンペーンのレスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.qa.indeed.tech/ads",
    "perPage": 3,
    "links": null
  },
  "data": {
    "entries": [{
        "jobKey": "839d4e5b2b8ca2a6",
        "refNum": "267",
        "title": "Experienced Driver",
        "location": "London"
      },
      {
        "jobKey": "4191b62313a544aa",
        "refNum": "259",
        "title": "Branch Foreman",
        "location": "London"
      },
      {
        "jobKey": "2977cb389f748f51",
        "refNum": "305",
        "title": "Trainee Manager",
        "location": "London"
      }
    ],
    "hash": 964409796
  }
}

残りのページを取得します。

後続のリクエストは最初のリクエストと同じ形式に従います。新しいページを取得するには、startを前のリクエストのstartとperPageの合計に設定し、perPageを前のリクエストと同じに設定します。たとえば、最後のページがstart = 10、perPage = 5で取得された場合、次のページはstart = 15、perPage = 5でリクエストできます。キャンペーンがスポンサーするすべての求人を取得するには、次のいずれかに達するまで連続するページを取得し続けます。
- レスポンスオブジェクトのperPageメタフィールドが、リクエストしたperPageと異なる。これは最終ページが読み取られたことを示します。
  
  perPageの最大値は500なので、リクエストされたperPageが500を超える場合、レスポンスでの差異が必ずしも最終ページに到達したことを示すとは限りません。
- レスポンスオブジェクトのhashフィールドが、前のページの値と異なる。これは読み取り中に求人リストが変更されたことを示します。クライアントは1分間一時停止してから、start = 0から読み取りを再開する必要があります。

レポートのハウツーガイド

キャンペーンパフォーマンスをレポートする

この例では、3日間のキャンペーンのパフォーマンスデータをリクエストします。

この例では、結果セットの集計と日別の内訳の両方を提供します。

キャンペーンパフォーマンスレポートのスコープを持つアクセストークンを使用する

キャンペーンパフォーマンスレポートのスコープを持つアクセストークンを使用する
scope	`employer_access employer.advertising.campaign_report.read`

キャンペーンパフォーマンスレポートのキャンペーンIDを取得する

キャンペーンを一覧表示するには、定期キャンペーンのキャンペーンIDを取得するを参照してください。

キャンペーン統計を取得する

キャンペーンパフォーマンスレポートのAPI詳細

キャンペーンパフォーマンスレポート
API URL	`https://apis.indeed.com/ads/v1/campaigns/{YourCampaignIdFromStep2}/stats` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

キャンペーンパフォーマンスレポートのリクエストパラメータ

キャンペーンパフォーマンスレポートのリクエストパラメータ
キー	値
`startDate`	2021-07-16
`endDate`	2021-07-31
`merge`	`TRUE` 日別の内訳を取得するには`FALSE`に設定します。

APIレスポンス（Merge = TRUE）

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
      "rel": "up",
      "href": "/v1/campaigns//b0fxxxxxxxxx327/stats"
    }]
  },
  "data": {
    "Name": "TMN test UK - Target Applies",
    "Id": "/b0fxxxxxxxxx327",
    "StartDate": "2021-07-22",
    "EndDate": "2021-07-24",
    "Clicks": 989,
    "Impressions": 8384,
    "Conversions": 217,
    "CurrencyCode": "USD",
    "Cost": 598.69,
    "OrganicClicks": 35,
    "OrganicImpressions": 303,
    "Applystarts": 320,
    "OrganicApplystarts": 18
  }
}

APIレスポンス（Merge = FALSE）

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 10,
    "links": [
      {
        "rel": "up",
        "href": "/v1/campaigns//b0fxxxxxxxxx327/stats"
      }
    ]
  },
  "data": {
    "entries": [
      {
        "Name": "TMN test UK - Target Applies",
        "Id": "/b0fxxxxxxxxx327",
        "Date": "2021-07-22",
        "Clicks": 373,
        "Impressions": 3238,
        "Conversions": 83,
        "CurrencyCode": "USD",
        "Cost": 258.76,
        "OrganicClicks": 22,
        "OrganicImpressions": 226,
        "Applystarts": 125,
        "OrganicApplystarts": 9
      },
      {
        "Name": "TMN test UK - Target Applies",
        "Id": "/b0fxxxxxxxxx327",
        "Date": "2021-07-23",
        "Clicks": 318,
        "Impressions": 2665,
        "Conversions": 74,
        "CurrencyCode": "USD",
        "Cost": 178.28,
        "OrganicClicks": 7,
        "OrganicImpressions": 42,
        "Applystarts": 104,
        "OrganicApplystarts": 4
      },
      {
        "Name": "TMN test UK - Target Applies",
        "Id": "/b0fxxxxxxxxx327",
        "Date": "2021-07-24",
        "Clicks": 298,
        "Impressions": 2481,
        "Conversions": 60,
        "CurrencyCode": "USD",
        "Cost": 161.65,
        "OrganicClicks": 6,
        "OrganicImpressions": 35,
        "Applystarts": 91,
        "OrganicApplystarts": 5
      }
    ]
  }
}

キャンペーンパフォーマンスレポートのAPI呼び出し

アカウント管理の手順ガイド

採用企業アカウント情報を取得する

採用企業のID、連絡先情報などを取得します。

採用企業アカウント用のスコープを持つアクセストークンを使用します。

採用企業アカウント情報を取得する
scope employer_access employer.advertising.account.read

アカウントエンドポイントにクエリを実行します。

採用企業アカウントのAPI詳細：

採用企業アカウントのAPI詳細
API URL	`https://apis.indeed.com/ads/v1/account` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0 bearer token

採用企業アカウントのサンプルレスポンス：

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": {
    "employerId": "a2973d75fd4xxxxxxx748785257446e7",
    "jobSourceList": [
      {
        "id": "a284xxxxxxx1c1f9",
        "siteName": "MyCompany"
      }
    ],
    "contact": "",
    "company": "My Company Name",
    "id": "4958xxxxxxx3732",
    "email": "myEmailAddress@indeed.com"
  }
}

サブアカウント情報を取得する

特定のマスターアカウントのサブアカウントの詳細リストを取得します。

サブアカウント情報用のスコープを持つアクセストークンを使用します。

この操作のためにアクセストークンを取得する際は、employerパラメーターを含めないでください。

サブアカウント情報を取得する
scope employer.advertising.subaccount.read

サブアカウント情報を取得する
scope	`employer.advertising.subaccount.read`

サブアカウントエンドポイントにクエリを実行します。

サブアカウントエンドポイントにクエリするためのAPI詳細：

サブアカウントクエリのAPI詳細
API URL	`https://apis.indeed.com/ads/v1/subaccounts` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0 bearer token

サブアカウントエンドポイントへのクエリのサンプルレスポンス：

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 2,
    "links": {
      "rel": "next",
      "href": "/V1/campaigns/3141xxxxxxxxx793"
    }
  },
  "data": {
    "SubAccountList": {
      "id": "3141xxxxxxxxx793",
      "employerId": "4bc39xxxxxxxxx8efbc8486",
      "company": "MyTestCompany",
      "email": "example@mytestcompany.com"
    }
  }
}

サブアカウントを作成する

マスターアカウントにサブアカウントを追加します。

サブアカウントを作成するためのスコープを持つアクセストークンを使用します。

この操作のためにアクセストークンを取得する際は、employerパラメーターを含めないでください。

サブアカウントを作成する
scope employer.advertising.subaccount

サブアカウントを作成する
scope	`employer.advertising.subaccount`

サブアカウントエンドポイントを作成します。

サブアカウントエンドポイントを作成するAPI詳細：

サブアカウント作成のAPI詳細
API URL	`https://apis.indeed.com/ads/v1/subaccounts` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0 bearer token

サブアカウントエンドポイントを作成するサンプルリクエスト：

{
  "email": "testsubaccount@mytestcompany.com",
  "currencyCode": "USD",
  "language": "en",
  "employeeCount": "1-49",
  "company": "MyTestCompany2"
}

サブアカウント作成のサンプルレスポンス：

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": {
    "id": "31xxxxxxxxx794",
    "employerId": "4bc39xxxxxxxxx8efbc8486",
    "company": "MyTestCompany2",
    "email": "testsubaccount@mytestcompany.com",
  }
}

アカウント予算を取得する

アカウントの月次予算を取得します。

アカウント予算用のスコープを持つアクセストークンを使用します。
scope employer_access employer.advertising.account.read
アカウント予算エンドポイントを取得します。アカウント予算を取得するAPI詳細：
API URL
https://apis.indeed.com/ads/v1/account/budget （Sponsored Jobs APIリファレンス）
リクエストタイプ GET
コンテンツタイプ application/json
認証 OAuth 2.0 bearer token
アカウント予算取得のサンプルレスポンス：
予算が設定されていない場合、jobsMonthlyBudgetレスポンスフィールドはnullを返します。
```
{
  "meta": 
  { 
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": 
      [
        {
         "rel": "up",
         "href": "/v1/account"
        }
      ],
    "data": 
      {
        "jobsMonthlyBudget": null
      }
  }
}
```

API URL	`https://apis.indeed.com/ads/v1/account/budget` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0 bearer token

アカウント予算を設定する

アカウントの月次予算を更新します。

アカウント予算を設定するためのスコープを持つアクセストークンを使用します。
scope employer_access employer.advertising.account
アカウント予算エンドポイントにクエリを実行します。
アカウント予算を設定する：API詳細：
API URL
https://apis.indeed.com/ads/v1/account/budget （Sponsored Jobs APIリファレンス）
リクエストタイプ PATCH
コンテンツタイプ application/json
認証 OAuth 2.0 bearer token
アカウント予算を設定する：サンプルリクエスト：
```
{ "jobsMonthlyBudget": 20000 }
```
アカウント予算を設定する：サンプルレスポンス：
```
{
  "meta": &#123;
  "status": 200,
  "errors": null,
  "rootLocation": "https://apis.indeed.com/ads",
  "perPage": null,
  "links": [
    {
      "rel": "up",
      "href": "/v1/account"
    }
  ],
  "data": ""
}
```
この更新を行った後にアカウント予算を取得するを呼び出すと、次のレスポンスを受け取ります。
```
{
  "meta":
  {
    "status": 200,
  "errors": null,
  "rootLocation": "https://apis.indeed.com/ads",
  "perPage": null,
  "links": [
    "rel": "up",
    "href": "/v1/account"
    ],
  "data":
    {
      "jobsMonthlyBudget": 20000.00
    }
  }
}
```
Indeed UIでの月次求人予算設定：
Indeed UIでの月次予算設定

scope	`employer_access employer.advertising.account`

API URL	`https://apis.indeed.com/ads/v1/account/budget` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`PATCH`
コンテンツタイプ	`application/json`
認証	OAuth 2.0 bearer token

APIクォータ使用状況の手順ガイド

広告主の API クォータ使用状況を取得する

指定した月の広告主の Sponsored Jobs API 使用状況、クォータ、およびスポンサー求人の支出額を取得します。

API 使用回数には当日のデータは表示されません。支出額は、当月については現在日付までの合計支出額、完了した月についてはその月の合計支出額を表します。

APIクォータ使用状況詳細用のスコープを持つアクセストークンを使用します。

広告主の API クォータ使用状況を取得する
scope	`employer_access employer.advertising.account.read`

APIクォータ使用状況エンドポイントを呼び出して、APIクォータ使用状況を取得します。

広告主の API クォータ使用状況取得の API 詳細
API URL	`https://apis.indeed.com/ads/v1/apiquotausage` （Sponsored Jobs APIリファレンス）
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0 bearer token

APIクォータ使用状況のリクエストパラメーター：

広告主の API クォータ使用状況取得のリクエストパラメーター
キー	値
`monthYear`	クォータ使用状況データを取得する月（MMyyyy形式、例：2024年12月の場合は122024）。未来の月や2024年12月（122024）より前の月は指定できません。任意 - 指定しない場合は当月がデフォルトになります。

APIクォータ使用状況のGETのサンプルレスポンス：

  {
    "meta": {
      "status": 200,
      "errors": null,
      "rootLocation": "https://apis.indeed.com/ads",
      "perPage": null,
      "links": null
    },
    "data": {
      "mmyyyy": "112024",
      "apiQuota": 1500,
      "sponsoredJobsSpendAmount": 3000,
      "currencyCode": "USD",
      "apiUsage": [
        {
          "requestsCount": 1000
        }
      ]
    }
  }

推奨事項とガイドライン

結果整合性に備える

このAPIは結果整合性モデルを採用しています。たとえば、POST /v1/campaignsを呼び出してキャンペーンを作成した直後は、GET /v1/campaigns/{campaignId}が新しいキャンペーンを返さないことが短時間発生する場合があります。

結果整合性に対応するため、リソースを作成または更新した直後にそのリソースを読み取らないでください。成功レスポンス（200、201、またはその他の成功コード）は、Indeedが変更を保存したことを示します。確認のために追加でGETを実行する必要はありません。

作成または更新の直後にリソースを読み取る必要がある場合は、変更が反映されるまで待機するリトライ処理を追加してください。

API変更との互換性を確保する

Indeedは、Sponsored Jobs APIへの下位互換性のある変更を、事前の通知なしにいつでもリリースできます。下位互換性のある変更には次のものがあります。

レスポンスフィールドの追加。
レスポンスフィールドの並べ替え。
エラー説明の更新。
新しい通貨と目的タイプのサポート。

下位互換性のある変更によって問題が発生しないように、アプリは次のガイドラインに従う必要があります。

JSONレスポンスの不明なプロパティを無視する。
JSONレスポンスのプロパティを任意の順序で受け入れる。
エラーを区別するには、descriptionプロパティではなくtypeプロパティを使用する。

また、アプリのみが管理しているわけではない採用企業アカウントとアプリが連携する場合、別のサードパーティアプリまたはIndeed 求人掲載が作成したリソースに遭遇する可能性があります。アプリは次の状況に対応する必要があります。

別のアプリが作成したキャンペーンを取得または更新すると、INCOMPATIBLE_API_VERSIONエラーが返される場合があります。
別のアプリが作成したキャンペーンやサブアカウントは、アプリがサポートしていない通貨コードを使用している場合があります。アプリは、いずれのISO 4217通貨コードも処理できる必要があります。
別のアプリが作成したキャンペーンは、アプリがサポートしていない目的タイプを使用している場合があります。アプリは、予期しない目的タイプに対応するフォールバックロジックを備えている必要があります。

Javaで開発している場合、一般的なJacksonライブラリは、デフォルトで不明なプロパティに対して失敗します。この動作を変更するには、@JsonIgnoreProperties(ignoreUnknown = true)を設定します。これにより、DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIESが無効になります。

FAQとトラブルシューティング

FAQ

Indeedはサンドボックス環境を提供していません。本番環境のIndeed APIからデータを読み取ることは、コストやアカウントへの影響なしに可能です。作成・更新操作をテストする場合は、支出を防ぐため、一時停止状態（status=paused）でテストキャンペーンを作成してください。

インデックス求人クエリ形式をご覧ください。

アカウント予算をクリアするには、カスタマーサクセス担当者にお問い合わせください。

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

このトピックでは、Sponsored Jobs API が返すエラーについて説明します。https://apis.indeed.com/oauth/v2/tokens などの認可エンドポイントが返すエラーについては、OAuth エラーのトラブルシューティングをご覧ください。

400から599などの正常でないHTTPステータスコードは、リクエストが失敗したことを示します。レスポンスボディには詳細が含まれます。たとえば、アクセストークンなしでSponsored Jobs APIを呼び出すと、次のようなレスポンスが返ります。

{
  "meta": {
    "status": 401,
    "errors": [{
      "type": "INVALID_TOKEN",
      "description": "Couldn't find access token in the request. The Authorization header is missing or incorrectly formatted."
    }],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": null
}

metaレスポンスフィールド内のerrors配列にエラーが含まれます。すべてのエラーにはtypeと人間が読めるdescriptionがあります。この表では、よくあるエラータイプを説明します。

リクエストパスのプレフィックスに/adsが付いていないため、レスポンスはリクエストをSponsored Jobs APIにルーティングできなかったことを示します。たとえば、https://apis.indeed.com/v1/accountの代わりにhttps://apis.indeed.com/ads/v1/accountを使用してください。

{
  "fault": {
    "faultstring": "Unable to identify proxy for host: apis and url: /v1/account",
    "detail": {
      "errorcode": "messaging.adaptors.http.flow.ApplicationNotFound"
    }
  }
}

HTTPステータスコード
HTTPステータス	エラータイプ	説明と一般的な原因
`400`	`DATE_RANGE_TOO_LONG`	`startDate`と`endDate`リクエストパラメーターの値が離れすぎていることを示します。`endDate`は`startDate`から最大366日後までです。より長い日付範囲のデータが必要な場合は、366日以下のバッチにリクエストを分割してください。このエラーを返すのは、`GET /v1/campaigns/{campaignId}/stats`と`GET /v1/campaigns/{campaignId}/stats/entryDates`のみです。
`400`	`INCOMPATIBLE_API_VERSION`	アプリが呼び出すSponsored Jobs APIバージョンと互換性のないリソースを、アプリが取得または更新しています。このエラーは、アプリ外のエンティティがリソースを作成または変更した場合に発生します。このエラーは将来の使用のために予約されており、現在は返されません。
`400`	`INVALID_ADVERTISEMENT_ID`	リクエストに含まれるキャンペーンIDが切り捨てられたり、想定外の文字が含まれていたり、または形式が不正でした。
`400`	`INVALID_REQUEST`	リクエストパラメーターのいずれかに問題があります。必須パラメーターが欠落している。パラメーターの値が無効である。サポートされなくなったパラメーターがリクエストに含まれている。リクエストに、一緒に使用できないパラメーターの組み合わせが含まれている。 `description`フィールドには通常、問題のあるパラメーター名とより詳細なエラーメッセージが含まれます。例： `{ "meta": { "errors": [{ "type": "INVALID_REQUEST", "description": "jobsToInclude: One of \"all\", \"query\"" }] } }` 他のエラータイプとは異なり、`meta.errors`配列には、問題のあるリクエストパラメーターごとに複数の`INVALID_REQUEST`エラーが含まれる場合があります。
`400`	`UNACCEPTED_PARAMETER`	`advertiserId`パラメーターを使用してアクセス対象のサブアカウントを指定することはサポートされなくなりました。代わりに、アクセストークンをリクエストする際に`employer`パラメーターを含めてください。 `employer`パラメーターが受け付ける採用企業IDは、レガシーの`advertiserId`パラメーターが受け付ける値とは異なります。`GET /v1/subaccounts`エンドポイントは、サブアカウントの採用企業IDとレガシーIDの両方を返すようになりました。
`400`	`NOT_MASTER_ACCOUNT`	このAPIエンドポイントはマスターアカウントでのみ呼び出せます。現時点では、このエラーは`GET /v1/subaccounts`と`POST /v1/subaccounts`のみから返されます。
`401`	`INVALID_TOKEN`	リクエストに有効なアクセストークンが含まれていません。 `Authorization`ヘッダーが欠落しているか、形式が不正です。アクセストークンは`Authorization` HTTPヘッダーで送信し、値の前に`Bearer`という単語とスペースを付けてください。たとえば、アクセストークンが`XYZ`の場合、リクエストには`Authorization: Bearer XYZ`ヘッダーを含める必要があります。アクセストークンの形式が不正でした。HTTPリクエストを手動で構築してAPIをテストしている場合、リクエストにコピーする際に、アクセストークンの先頭または末尾の文字が欠落したり、余分な文字が含まれていたりしないか確認してください。アクセストークンの有効期限が切れています。アクセストークンは1時間（3,600秒）のみ有効です。それを過ぎたら、クライアントクレデンシャル（2-legged OAuth）またはリフレッシュトークン（3-legged OAuth）を使用して別のアクセストークンを取得する必要があります。
`403`	`EMPLOYER_ACCESS_TOKEN_NOT_ALLOWED`	このAPIエンドポイントは、採用企業を表すアクセストークンではアクセスできません。理由は次のいずれかです。このAPIエンドポイントはマスターアカウントでのみ呼び出せます。この操作のためにアクセストークンをリクエストする際は、`employer`パラメーターを省略してください。現時点では、このエラーは`GET /v1/subaccounts`と`POST /v1/subaccounts`のみから返されます。新しいAPIエンドポイントではなく、レガシーのSponsored Jobs APIエンドポイントを呼び出しています。必ず新しいエンドポイント（`https://apis.indeed.com/ads`）を使用してください。
`403`	`INSUFFICIENT_SCOPE`	アクセストークンは有効でしたが、このAPIエンドポイントに必要なスコープを持っていませんでした。クライアントクレデンシャルグラントタイプ（2-legged OAuth）を使用している場合： `https://apis.indeed.com/oauth/v2/tokens`を呼び出す際に、`scope`パラメーターに必要なスコープを含めませんでした。OAuth手順に戻り、必要なスコープを含むアクセストークンをリクエストしてください。呼び出すエンドポイントに必要なスコープを確認するには、スコープをご覧ください。アプリのアカウントに、この採用企業への管理者アクセスが付与されていません。アプリが持つアクセスレベルは、Manage accessで確認できます。認可コードグラントタイプ（3-legged OAuth）を使用している場合：ユーザーを`https://secure.indeed.com/oauth/v2/authorize`にリダイレクトする際に、`scope`パラメーターに必要なスコープを含めませんでした。呼び出すエンドポイントに必要なスコープを確認するには、スコープをご覧ください。ユーザーがアプリに必要なスコープを付与しなかったか、ユーザーに採用企業への管理者アクセスが付与されていません。これらの条件は、`https://apis.indeed.com/oauth/v2/tokens`から返される`consented_scope`レスポンスフィールドを確認することで区別できます。このフィールドには、採用企業へのアクセスレベルに関係なく、ユーザーがアプリに付与したすべての権限が含まれます。 `GET /v1/account`は特別なケースであることに注意してください。サブアカウントを含む採用企業の詳細を取得するには、必要なスコープは`employer.advertising.account.read`であり、アクセストークンは採用企業を表す必要があります。マスターアカウント自体の詳細を取得するには、必要なスコープは`employer.advertising.subaccount.read`（原文ママ）であり、アクセストークンはユーザーアカウントを採用企業アカウントに紐づけてはいけません。
`403`	`LEGACY_ACCESS_TOKEN_NOT_ALLOWED`	Sponsored Jobs APIは、レガシーのOAuthエンドポイントを通じて取得したアクセストークンをサポートしなくなりました。更新されたエンドポイントについては、Indeedとの連携とAPIの呼び出しをご覧ください。
`403`	`NOT_EMPLOYER_ACCESS_TOKEN`	`EMPLOYER_ACCESS_TOKEN_NOT_ALLOWED`の逆です。このエンドポイントには、ユーザーアカウントを採用企業アカウントに紐づけるアクセストークンが必要です。アクセストークンをリクエストする際に`employer`パラメーターを指定する必要があります。ほとんどのSponsored Jobs APIエンドポイントでこの指定が必要です。
`404`	`RESOURCE_NOT_FOUND`	リクエストURLに問題があったことを示します。リクエストされたキャンペーンが存在しないか、別の採用企業に属しています。リクエストされたキャンペーンを所有する採用企業アカウントにユーザーアカウントを紐づけるアクセストークンを必ず使用してください。リクエストされた日付に対応するキャンペーン統計がありません。リクエストされた日付より後にキャンペーンが作成された、リクエストされた日付にキャンペーンがアクティブでなかった、または最近の日付の場合はまだデータが処理中です。リクエストパスのスペルが誤っています。APIリファレンスドキュメントで正しいURLパターンを確認してください。
`500`	すべて（通常は`INTERNAL_SERVER_ERROR`）	想定外のエラー。問題は一時的な場合があります。リトライ後に同じリクエストが成功することがあります。リクエストをリトライしても解決しない場合、リクエストの解析で問題が発生した可能性があります。すべての必須パラメーターが含まれており、すべてのパラメーターが正しい形式であることを確認してください。クライアントクレデンシャルグラントタイプ（2-legged OAuth）で取得したアクセストークンをレガシーのSponsored Jobs APIエンドポイントで使用しようとしても、`INTERNAL_SERVER_ERROR`が表示されます。`https://apis.indeed.com/ads`エンドポイントを必ず使用してください。

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

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

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

このページの内容

前提条件
キャンペーン管理のハウツーガイド
レポートのハウツーガイド
- キャンペーンパフォーマンスをレポートする
アカウント管理の手順ガイド
APIクォータ使用状況の手順ガイド
- 広告主の API クォータ使用状況を取得する
推奨事項とガイドライン
- 結果整合性に備える
- API変更との互換性を確保する
FAQとトラブルシューティング
- FAQ
- よくあるエラーをトラブルシューティングする
OAuthエラーをトラブルシューティングする

On this page

前提条件​

OAuthを設定する​

OAuth v2トークンスコープ​

OAuthアクセストークンを取得する​

tokensエンドポイントのAPI詳細​

tokensエンドポイントのリクエストパラメータ​

tokensエンドポイントのレスポンス例​

キャンペーン管理のハウツーガイド​

キャンペーン予算見積もりを取得する​

単発キャンペーンを作成する​

目標ベースのキャンペーンを作成する​

定期キャンペーンを作成する​

定期キャンペーン情報を更新する​

キャンペーン予算を更新する​

キャンペーン期間を更新する​

キャンペーン内の求人の詳細を取得する​

レポートのハウツーガイド​

キャンペーンパフォーマンスをレポートする​

キャンペーンパフォーマンスレポートのスコープを持つアクセストークンを使用する​

キャンペーンパフォーマンスレポートのキャンペーンIDを取得する​

キャンペーン統計を取得する​

キャンペーンパフォーマンスレポートのAPI詳細​

キャンペーンパフォーマンスレポートのリクエストパラメータ​

APIレスポンス（Merge = TRUE）​

APIレスポンス（Merge = FALSE）​

キャンペーンパフォーマンスレポートのAPI呼び出し​

アカウント管理の手順ガイド​

採用企業アカウント情報を取得する​

サブアカウント情報を取得する​

サブアカウントを作成する​

アカウント予算を取得する​

アカウント予算を設定する​

APIクォータ使用状況の手順ガイド​

広告主の API クォータ使用状況を取得する​

推奨事項とガイドライン​

結果整合性に備える​

API変更との互換性を確保する​

FAQとトラブルシューティング​

FAQ​

よくあるエラーをトラブルシューティングする​

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

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

このページの内容

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

前提条件

OAuthを設定する

OAuth v2トークンスコープ

OAuthアクセストークンを取得する

tokensエンドポイントのAPI詳細

tokensエンドポイントのリクエストパラメータ

tokensエンドポイントのレスポンス例

キャンペーン管理のハウツーガイド

キャンペーン予算見積もりを取得する

単発キャンペーンを作成する

目標ベースのキャンペーンを作成する

定期キャンペーンを作成する

定期キャンペーン情報を更新する

キャンペーン予算を更新する

キャンペーン期間を更新する

キャンペーン内の求人の詳細を取得する

レポートのハウツーガイド

キャンペーンパフォーマンスをレポートする

キャンペーンパフォーマンスレポートのスコープを持つアクセストークンを使用する

キャンペーンパフォーマンスレポートのキャンペーンIDを取得する

キャンペーン統計を取得する

キャンペーンパフォーマンスレポートのAPI詳細

キャンペーンパフォーマンスレポートのリクエストパラメータ

APIレスポンス（Merge = TRUE）

APIレスポンス（Merge = FALSE）

キャンペーンパフォーマンスレポートのAPI呼び出し

アカウント管理の手順ガイド

採用企業アカウント情報を取得する

サブアカウント情報を取得する

サブアカウントを作成する

アカウント予算を取得する

アカウント予算を設定する

APIクォータ使用状況の手順ガイド

広告主の API クォータ使用状況を取得する

推奨事項とガイドライン

結果整合性に備える

API変更との互換性を確保する

FAQとトラブルシューティング

FAQ

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

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