キャンペーンの予算と期間を更新

PATCH 
/v1/campaigns/:campaignId/budget

キャンペーンの予算、期間、またはその両方を更新します。NullまたはないプロパティはCurrentの値を維持します。ボーナスクレジットキャンペーンには使用できません。

OAuthスコープ	アクセストークンタイプ
employer.advertising.campaign	採用企業を表すアクセストークン。採用企業を表すアクセストークンを取得するを参照してください。

Request

Path Parameters

campaignId stringrequired

キャンペーンID。

application/json

Body

required

'リクエストにContent-Type: application/jsonヘッダーを含めてください。'

budgetOnetimeLimit number

設定されている場合、キャンペーンはキャンペーン全体の期間に対して単一の予算を持ちます。常にbudgetOnetimeLimitまたはbudgetMonthlyLimitのいずれかを指定する必要がありますが、両方は指定できません。

予算は採用企業アカウントの通貨で表示されます。Sponsored Jobs APIは値を浮動小数点数ではなく正確な小数として解析、保存、返却します。

budgetMonthlyLimit number

キャンペーンの月次定期予算。月次定期予算を持つキャンペーンの終了日はオプションです。budgetOnetimeLimitまたはbudgetMonthlyLimitのどちらか1つを指定する必要があります。

予算は採用企業アカウントの通貨で表示されます。Sponsored Jobs APIは値を浮動小数点数ではなく正確な小数として解析、保存、返却します。

budgetFirstMonthBehavior string

Possible values: [startNowProratedAmount, startNowFullAmount, startNextMonthFullAmount]

キャンペーンに月次定期予算（budgetMonthlyLimitが指定されている）があり、キャンペーンの開始日が月の最初の日でない場合、最初の月の予算の計算方法を指定します。

値	意味	例: 月次予算が900 USDで開始日が6月11日の場合の適用予算
		6月11日〜30日	7月1日〜31日
startNowFullAmount	最初の月の予算は月次全額です。	900 USD	900 USD
startNowProratedAmount	最初の月の予算は、開始日以降の月の残り日数に比例します。	600 USD	900 USD
startNextMonthFullAmount	キャンペーンは最初の月に予算がなく、求人をスポンサーしません。	0 USD	900 USD

startDate date

キャンペーンが求人のスポンサーを開始する日付。ISO 8601のYYYY-MM-DD形式。デフォルトは現在の日付です。

キャンペーンは指定された日付の米国中部時間（CT、US/Central）の開始時に求人のスポンサーを開始します。開始日はCTの現在日付以降である必要があります。例えば、startDateが2021-01-15の場合、キャンペーンは2021年1月15日の午前0:00 CTにスポンサーを開始します。開始日が指定されていないか現在の日付の場合、キャンペーンはすぐにスポンサーを開始します。

キャンペーンがアクティブで支出中の場合、startDateを更新できません。キャンペーンを一時的に一時停止する場合は、statusをPAUSEDに設定します。

fixedEndDate date

残りの未使用予算があっても、キャンペーンが求人のスポンサーを停止しなければならない日付。ISO 8601のYYYY-MM-DD形式に従います。

一括予算（budgetOnetimeLimit）を持つキャンペーンには、常にfixedEndDateまたはtargetEndDateのいずれか1つが必要ですが、両方は指定できません。

月次定期予算（budgetMonthlyLimit）を持つキャンペーンには、オプションでfixedEndDateを設定できます。月次定期キャンペーンは、手動で一時停止または削除するまで求人のスポンサーを続けます。これらは「エバーグリーン」キャンペーンと呼ばれます。指定された日の開始時にキャンペーンを停止するには、fixedEndDateを指定します。

キャンペーンは指定された日付の米国中部時間（CT、US/Central）の開始時に求人のスポンサーを停止します。fixedEndDateはCTの現在日付から少なくとも1日後、またはキャンペーンがある場合はキャンペーンのstartDateから少なくとも1日後である必要があります。例えば、固定終了日が2021-06-20の場合、キャンペーンは2021年6月20日の午前0:00 CTに停止します。

targetEndDate date

キャンペーンが求人のスポンサーを停止すべき日付ですが、予算がまだ残っている場合は指定された日付を過ぎてもスポンサーを続ける場合があります。ISO 8601のYYYY-MM-DD形式に従います。

一括予算（budgetOnetimeLimit）を持つキャンペーンには、常にfixedEndDateまたはtargetEndDateのいずれか1つが必要ですが、両方は指定できません。月次定期予算（budgetMonthlyLimit）を持つキャンペーンにはtargetEndDateを設定できず、fixedEndDateまたは終了日なしのみ設定できます。

キャンペーンは指定された日付の米国中部時間（CT、US/Central）の開始を目標とします。目標終了日はCTの現在日付から少なくとも1日後、またはキャンペーンがある場合はキャンペーンのstartDateから少なくとも1日後である必要があります。例えば、目標終了日が2021-06-20の場合、キャンペーンは2021年6月20日の午前0:00 CTを目標とします。

Responses

200

成功

application/json

Schema

Schema

meta

object

レスポンス関連のメタデータ。

status int32

レスポンスのHTTPステータスコード。

errors

object[]

リクエストの正常な処理を妨げたエラー。エラーがなかった場合、値はnullです。

Array [

type string

エラーの名前。

description string

問題の人間が読める説明。

]

rootLocation string

Sponsored Jobs APIのベースURL。

perPage int32

ページネーションされた結果を返すエンドポイントの場合、1ページに返されるエントリの実際の最大数。perPageパラメータでリクエストした最大値より小さい場合があります。エンドポイントが単一の結果を返すかページネーションしない場合、値はnullです。

links

object[]

リクエストされたリソースに関連するリソース。

Array [

rel string

リクエストされたリソースと関連リソースの関係。一般的に使用される値:

• up: 関連リソースは、リクエストされたリソースを含むコレクション、またはリクエストされたリソースが関連付けられているエンティティです。
• next: ページネーションされた結果の次のページ。
• prev: ページネーションされた結果の前のページ。

ただし、値はCampaign Infoなどの関係を説明する任意の文字列の場合もあります。

href string

関連リソースのエンドポイントURL。クエリ文字列パラメータを含む場合があります。完全なURLを取得するには、hrefをrootLocationに追加します。

]

data

object

campaignId string

更新されたキャンペーンのキャンペーンID。

Example (from schema)

{
  "meta": {
    "status": 200,
    "errors": [
      {
        "type": "RESOURCE_NOT_FOUND",
        "description": "Couldn't locate the requested resource"
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 25,
    "links": [
      {
        "rel": "next",
        "href": "/v1/campaigns/3141592653589793"
      }
    ]
  },
  "data": {
    "campaignId": "cda7fa7645b613d5"
  }
}

Example

{
  "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/bceed88523d89731"
      },
      {
        "rel": "Traffic Statistics",
        "href": "/v1/campaigns/bceed88523d89731/stats"
      }
    ]
  },
  "data": {
    "campaignId": "bceed88523d89731"
  }
}

400

リクエストパラメータが無効です。descriptionフィールドには通常、問題のあるパラメータの名前とより詳細なエラーメッセージが含まれます。 他のエラータイプとは異なり、meta.errors配列には、問題のあるリクエストパラメータごとに1つずつ、複数のINVALID_REQUESTエラーが含まれる場合があります。

application/json

Schema

Schema

meta

object

レスポンス関連のメタデータ。

status int32

レスポンスのHTTPステータスコード。

errors

object[]

リクエストの正常な処理を妨げたエラー。エラーがなかった場合、値はnullです。

Array [

type string

エラーの名前。

description string

問題の人間が読める説明。

]

rootLocation string

Sponsored Jobs APIのベースURL。

perPage int32

ページネーションされた結果を返すエンドポイントの場合、1ページに返されるエントリの実際の最大数。perPageパラメータでリクエストした最大値より小さい場合があります。エンドポイントが単一の結果を返すかページネーションしない場合、値はnullです。

links

object[]

リクエストされたリソースに関連するリソース。

Array [

rel string

リクエストされたリソースと関連リソースの関係。一般的に使用される値:

• up: 関連リソースは、リクエストされたリソースを含むコレクション、またはリクエストされたリソースが関連付けられているエンティティです。
• next: ページネーションされた結果の次のページ。
• prev: ページネーションされた結果の前のページ。

ただし、値はCampaign Infoなどの関係を説明する任意の文字列の場合もあります。

href string

関連リソースのエンドポイントURL。クエリ文字列パラメータを含む場合があります。完全なURLを取得するには、hrefをrootLocationに追加します。

]

data object

Example (from schema)

{
  "meta": {
    "status": 200,
    "errors": [
      {
        "type": "RESOURCE_NOT_FOUND",
        "description": "Couldn't locate the requested resource"
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 25,
    "links": [
      {
        "rel": "next",
        "href": "/v1/campaigns/3141592653589793"
      }
    ]
  },
  "data": null
}

Updating start date after campaign is active

{
  "meta": {
    "status": 400,
    "errors": [
      {
        "type": "INVALID_REQUEST",
        "description": "startDate: Cannot update the start date for this campaign."
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [
      {
        "rel": "up",
        "href": "/v1/campaigns"
      }
    ]
  },
  "data": null
}

Multiple types of end date

{
  "meta": {
    "status": 400,
    "errors": [
      {
        "type": "INVALID_REQUEST",
        "description": "targetEndDate: You can only have one end date type, either fixed or target."
      },
      {
        "type": "INVALID_REQUEST",
        "description": "fixedEndDate: You can only have one end date type, either fixed or target."
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [
      {
        "rel": "up",
        "href": "/v1/campaigns"
      }
    ]
  },
  "data": null
}

401

リクエストに有効なアクセストークンが含まれていませんでした:

• Authorizationヘッダーが欠落しているか不正な形式でした。HTTPのAuthorizationヘッダーにアクセストークンを含め、値の前にBearerという単語とスペースを付けてください。例えば、アクセストークンがXYZの場合、リクエストにはAuthorization: Bearer XYZヘッダーを含める必要があります。

• アクセストークンの形式が不正でした。HTTPリクエストを手動で構築してAPIをテストしている場合、リクエストにコピーする際にアクセストークンの先頭または末尾の文字を省略したり余分な文字を含めたりしていないか確認してください。

• アクセストークンが期限切れです。アクセストークンは1時間（3,600秒）のみ有効です。その後、クライアント資格情報（2-legged OAuth）またはリフレッシュトークン（3-legged OAuth）を使用して別のアクセストークンを取得する必要があります。

application/json

Schema

Schema

meta

object

レスポンス関連のメタデータ。

status int32

レスポンスのHTTPステータスコード。

errors

object[]

リクエストの正常な処理を妨げたエラー。エラーがなかった場合、値はnullです。

Array [

type string

エラーの名前。

description string

問題の人間が読める説明。

]

rootLocation string

Sponsored Jobs APIのベースURL。

perPage int32

ページネーションされた結果を返すエンドポイントの場合、1ページに返されるエントリの実際の最大数。perPageパラメータでリクエストした最大値より小さい場合があります。エンドポイントが単一の結果を返すかページネーションしない場合、値はnullです。

links

object[]

リクエストされたリソースに関連するリソース。

Array [

rel string

リクエストされたリソースと関連リソースの関係。一般的に使用される値:

• up: 関連リソースは、リクエストされたリソースを含むコレクション、またはリクエストされたリソースが関連付けられているエンティティです。
• next: ページネーションされた結果の次のページ。
• prev: ページネーションされた結果の前のページ。

ただし、値はCampaign Infoなどの関係を説明する任意の文字列の場合もあります。

href string

関連リソースのエンドポイントURL。クエリ文字列パラメータを含む場合があります。完全なURLを取得するには、hrefをrootLocationに追加します。

]

data object

Example (from schema)

{
  "meta": {
    "status": 200,
    "errors": [
      {
        "type": "RESOURCE_NOT_FOUND",
        "description": "Couldn't locate the requested resource"
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 25,
    "links": [
      {
        "rel": "next",
        "href": "/v1/campaigns/3141592653589793"
      }
    ]
  },
  "data": null
}

Example

{
  "meta": {
    "status": 401,
    "errors": [
      {
        "type": "INVALID_TOKEN",
        "description": "Invalid OAuth access token."
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": null
}

403

このAPIで使用できない有効なアクセストークンです。詳細については、meta.errorsで返されるエラーを確認してください。

エラータイプ	意味と一般的な原因
INSUFFICIENT_SCOPE	アクセストークンには、このAPIエンドポイントに必要なOAuth v2トークンスコープがありません。一般的な原因については、FAQとトラブルシューティングを参照してください。
NOT_EMPLOYER_ACCESS_TOKEN	このエンドポイントには、採用企業を表すアクセストークンが必要です。採用企業を表すアクセストークンを取得するを参照してください。つまり、アクセストークンをリクエストする際にemployerパラメータを指定する必要があります。Sponsored Jobs APIエンドポイントの大部分でこれが必要です。
LEGACY_ACCESS_TOKEN_NOT_ALLOWED	Sponsored Jobs APIはレガシーOAuthエンドポイントから取得したアクセストークンをサポートしなくなりました。更新されたエンドポイントについては、IndeedとAPIの統合と呼び出しを参照してください。

application/json

Schema

Schema

meta

object

レスポンス関連のメタデータ。

status int32

レスポンスのHTTPステータスコード。

errors

object[]

リクエストの正常な処理を妨げたエラー。エラーがなかった場合、値はnullです。

Array [

type string

エラーの名前。

description string

問題の人間が読める説明。

]

rootLocation string

Sponsored Jobs APIのベースURL。

perPage int32

ページネーションされた結果を返すエンドポイントの場合、1ページに返されるエントリの実際の最大数。perPageパラメータでリクエストした最大値より小さい場合があります。エンドポイントが単一の結果を返すかページネーションしない場合、値はnullです。

links

object[]

リクエストされたリソースに関連するリソース。

Array [

rel string

リクエストされたリソースと関連リソースの関係。一般的に使用される値:

• up: 関連リソースは、リクエストされたリソースを含むコレクション、またはリクエストされたリソースが関連付けられているエンティティです。
• next: ページネーションされた結果の次のページ。
• prev: ページネーションされた結果の前のページ。

ただし、値はCampaign Infoなどの関係を説明する任意の文字列の場合もあります。

href string

関連リソースのエンドポイントURL。クエリ文字列パラメータを含む場合があります。完全なURLを取得するには、hrefをrootLocationに追加します。

]

data object

Example (from schema)

{
  "meta": {
    "status": 200,
    "errors": [
      {
        "type": "RESOURCE_NOT_FOUND",
        "description": "Couldn't locate the requested resource"
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 25,
    "links": [
      {
        "rel": "next",
        "href": "/v1/campaigns/3141592653589793"
      }
    ]
  },
  "data": null
}

Example

{
  "meta": {
    "status": 403,
    "errors": [
      {
        "type": "INSUFFICIENT_SCOPE",
        "description": "Access token does not have permission to access this API."
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": null
}

404

リクエストされたキャンペーンが存在しないか、別の採用企業に属しています。リクエストされたキャンペーンを所有する採用企業を表すアクセストークンを使用してください。採用企業を表すアクセストークンを取得するを参照してください。

application/json

Schema

Schema

meta

object

レスポンス関連のメタデータ。

status int32

レスポンスのHTTPステータスコード。

errors

object[]

リクエストの正常な処理を妨げたエラー。エラーがなかった場合、値はnullです。

Array [

type string

エラーの名前。

description string

問題の人間が読める説明。

]

rootLocation string

Sponsored Jobs APIのベースURL。

perPage int32

ページネーションされた結果を返すエンドポイントの場合、1ページに返されるエントリの実際の最大数。perPageパラメータでリクエストした最大値より小さい場合があります。エンドポイントが単一の結果を返すかページネーションしない場合、値はnullです。

links

object[]

リクエストされたリソースに関連するリソース。

Array [

rel string

リクエストされたリソースと関連リソースの関係。一般的に使用される値:

• up: 関連リソースは、リクエストされたリソースを含むコレクション、またはリクエストされたリソースが関連付けられているエンティティです。
• next: ページネーションされた結果の次のページ。
• prev: ページネーションされた結果の前のページ。

ただし、値はCampaign Infoなどの関係を説明する任意の文字列の場合もあります。

href string

関連リソースのエンドポイントURL。クエリ文字列パラメータを含む場合があります。完全なURLを取得するには、hrefをrootLocationに追加します。

]

data object

Example (from schema)

{
  "meta": {
    "status": 200,
    "errors": [
      {
        "type": "RESOURCE_NOT_FOUND",
        "description": "Couldn't locate the requested resource"
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 25,
    "links": [
      {
        "rel": "next",
        "href": "/v1/campaigns/3141592653589793"
      }
    ]
  },
  "data": null
}

Example

{
  "meta": {
    "status": 404,
    "errors": [
      {
        "type": "RESOURCE_NOT_FOUND",
        "description": "Couldn't locate the requested resource."
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": {
      "rel": "up",
      "href": "/v1/campaigns"
    }
  },
  "data": null
}

500

予期しないエラーが発生しました。問題は一時的な場合があり、まったく同じリクエストを再試行すると成功する場合があります。

リクエストの再試行が役立たない場合は、リクエストの解析に問題が発生した可能性があります。必要なすべてのパラメータが存在し、すべてのパラメータが正しくフォーマットされていることを確認してください。

クライアント資格情報グラントタイプ（2-legged OAuth）で取得したアクセストークンをレガシーSponsored Jobs APIエンドポイントで使用した場合、INTERNAL_SERVER_ERRORエラーが発生します。最新のベースURL（https://apis.indeed.com/ads）を使用してください。

application/json

Schema

Schema

meta

object

レスポンス関連のメタデータ。

status int32

レスポンスのHTTPステータスコード。

errors

object[]

リクエストの正常な処理を妨げたエラー。エラーがなかった場合、値はnullです。

Array [

type string

エラーの名前。

description string

問題の人間が読める説明。

]

rootLocation string

Sponsored Jobs APIのベースURL。

perPage int32

ページネーションされた結果を返すエンドポイントの場合、1ページに返されるエントリの実際の最大数。perPageパラメータでリクエストした最大値より小さい場合があります。エンドポイントが単一の結果を返すかページネーションしない場合、値はnullです。

links

object[]

リクエストされたリソースに関連するリソース。

Array [

rel string

リクエストされたリソースと関連リソースの関係。一般的に使用される値:

• up: 関連リソースは、リクエストされたリソースを含むコレクション、またはリクエストされたリソースが関連付けられているエンティティです。
• next: ページネーションされた結果の次のページ。
• prev: ページネーションされた結果の前のページ。

ただし、値はCampaign Infoなどの関係を説明する任意の文字列の場合もあります。

href string

関連リソースのエンドポイントURL。クエリ文字列パラメータを含む場合があります。完全なURLを取得するには、hrefをrootLocationに追加します。

]

data object

Example (from schema)

{
  "meta": {
    "status": 200,
    "errors": [
      {
        "type": "RESOURCE_NOT_FOUND",
        "description": "Couldn't locate the requested resource"
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 25,
    "links": [
      {
        "rel": "next",
        "href": "/v1/campaigns/3141592653589793"
      }
    ]
  },
  "data": null
}

Example

{
  "meta": {
    "status": 500,
    "errors": [
      {
        "type": "INTERNAL_SERVER_ERROR",
        "description": "Failed to process the request."
      }
    ],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": null
}

Loading...

 

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