注意: API の REST インターフェースに関するドキュメントを表示しています。当社の公式クライアントライブラリのほとんどは gRPC を使用しています。詳しくは、REST の概要をご覧ください。

このページは Cloud Translation API によって翻訳されました。

CampaignBudget

JSON 表現
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

キャンペーンの予算

JSON 表現

JSON 表現
{ "resourceName": string, "status": enum (`BudgetStatus`), "deliveryMethod": enum (`BudgetDeliveryMethod`), "period": enum (`BudgetPeriod`), "type": enum (`BudgetType`), "alignedBiddingStrategyId": string, "id": string, "name": string, "amountMicros": string, "totalAmountMicros": string, "explicitlyShared": boolean, "referenceCount": string, "hasRecommendedBudget": boolean, "recommendedBudgetAmountMicros": string, "recommendedBudgetEstimatedChangeWeeklyClicks": string, "recommendedBudgetEstimatedChangeWeeklyCostMicros": string, "recommendedBudgetEstimatedChangeWeeklyInteractions": string, "recommendedBudgetEstimatedChangeWeeklyViews": string }

{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}

フィールド
`resourceName`	`string` 変更不可。キャンペーン予算のリソース名。キャンペーンの予算リソース名の形式は次のとおりです。 `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` 出力のみ。このキャンペーンの予算のステータス。このフィールドは読み取り専用です。
`deliveryMethod`	`enum (BudgetDeliveryMethod)` キャンペーン予算が消費される割合を決定する配信方法。作成オペレーションで指定しない場合のデフォルトは STANDARD です。
`period`	`enum (BudgetPeriod)` 変更不可。予算を消化する期間。指定しない場合のデフォルトは DAILY です。
`type`	`enum (BudgetType)` 変更不可。キャンペーン予算のタイプ。
`alignedBiddingStrategyId`	`string (int64 format)` この共有キャンペーン予算が調整されるポートフォリオ入札戦略の ID。入札戦略とキャンペーンの予算を調整すると、同じキャンペーン群に適用されます。キャンペーンの予算と入札戦略を調整した後、キャンペーンの予算に追加されるキャンペーンにも、調整された入札戦略を使用する必要があります。
`id`	`string (int64 format)` 出力のみ。キャンペーン予算の ID。キャンペーンの予算は、CampaignBudgetService 作成オペレーションを使用して作成され、予算 ID が割り当てられます。予算 ID は複数のキャンペーンで共有できます。そうすると、最適な結果が得られるよう、キャンペーンの予算が複数のキャンペーンに配分されます。
`name`	`string` キャンペーンの予算の名前。 CampaignBudgetService でキャンペーンの予算を作成する場合、明示的に共有されるキャンペーンの予算には必ず、null や空でない名前を指定してください。明示的に共有されていないキャンペーン予算の名前は、関連付けられたキャンペーンの名前に由来します。この文字列の長さは UTF-8 バイトで 1 ～ 255 の値にする必要があります（トリミングされる）。
`amountMicros`	`string (int64 format)` アカウントに対する現地通貨での予算額。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。1 か月の費用の上限はこの金額の 30.4 倍です。
`totalAmountMicros`	`string (int64 format)` アカウントに対する現地通貨での予算の生涯金額。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。
`explicitlyShared`	`boolean` 予算を明示的に共有するかどうかを指定します。作成オペレーションで指定しない場合のデフォルトは true です。 true の場合、予算は 1 つ以上のキャンペーンで共有する目的で作成されています。 false の場合、予算は 1 つのキャンペーンでのみ使用する目的で作成されています。予算の名前とステータスは、キャンペーンの名前やステータスと同期されたままになります。予算を 2 つ目のキャンペーンと共有しようとすると、エラーが発生します。共有されていない予算が明示的に共有される可能性があります。同じオペレーションで予算の名前も割り当てる必要があります。共有キャンペーンの予算は、非共有にすることはできません。
`referenceCount`	`string (int64 format)` 出力のみ。予算を使用しているキャンペーンの数。このフィールドは読み取り専用です。
`hasRecommendedBudget`	`boolean` 出力のみ。このキャンペーン予算に推奨予算があるかどうかを示します。このフィールドは読み取り専用です。
`recommendedBudgetAmountMicros`	`string (int64 format)` 出力のみ。推奨予算額。推奨がない場合は、予算額に設定されます。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。このフィールドは読み取り専用です。
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` 出力のみ。推奨予算を適用した場合に見込まれる週あたりのクリック数の変化。このフィールドは読み取り専用です。
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` 出力のみ。推奨予算を適用した場合に見込まれる週あたりの費用の変化（マイクロ秒単位）。100 万は 1 通貨単位に相当します。このフィールドは読み取り専用です。
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` 出力のみ。推奨予算を適用した場合に予測される 1 週間のインタラクション数の変化です。このフィールドは読み取り専用です。
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` 出力のみ。推奨予算を適用した場合に見込まれる週単位の視聴回数の変化です。このフィールドは読み取り専用です。

BudgetStatus

予算のステータス。

列挙型
`UNSPECIFIED`	指定されていません。
`UNKNOWN`	戻り値にのみ使用されます。このバージョンで不明な値を表します。
`ENABLED`	予算は有効になっています。
`REMOVED`	予算が削除されます。

BudgetDeliveryMethod

予算の配分方法。

列挙型
`UNSPECIFIED`	指定されていません。
`UNKNOWN`	戻り値にのみ使用されます。このバージョンで不明な値を表します。
`STANDARD`	予算サーバーは、全期間を通じて均等に広告配信を調整します。
`ACCELERATED`	予算サーバーによる広告配信が抑制されることはなく、広告はできるだけ早く配信されます。

BudgetPeriod

候補となる予算の期間。

列挙型
`UNSPECIFIED`	指定されていません。
`UNKNOWN`	戻り値にのみ使用されます。このバージョンで不明な値を表します。
`DAILY`	1 日の予算。
`CUSTOM_PERIOD`	カスタム予算は V5 で再度追加されました。カスタム予算と total_amount を併用して、全期間の予算の上限を指定できます。詳しくは、https://support.google.com/google-ads/answer/6385083 をご覧ください。

BudgetType

選択可能な予算タイプ。

列挙型
`UNSPECIFIED`	指定されていません。
`UNKNOWN`	戻り値にのみ使用されます。このバージョンで不明な値を表します。
`STANDARD`	Google 広告の標準的な利用の場合の予算タイプ。1 日の費用が、指定した予算額の 2 倍に制限されます。詳細: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	固定のコンバージョン単価（コンバージョン）が設定された予算タイプ。詳細: https://support.google.com/google-ads/answer/7528254 このタイプは、 AdvertisingChannelType.DISPLAY（ AdvertisingChannelSubType.DISPLAY_GMail を除く）、 BiddingStrategyType.TARGET_CPA、PaymentMode.CONVERSIONS のキャンペーンでのみサポートされます。
`SMART_CAMPAIGN`	スマートアシストキャンペーンの予算タイプ。詳細: https://support.google.com/google-ads/answer/7653509 このタイプは、 AdvertisingChannelType.SMART および AdvertisingChannelSubType.SMART_CAMPAIGN を使用しているキャンペーンでのみサポートされます。
`LOCAL_SERVICES`	ローカルサービスキャンペーンの予算タイプ。詳細: https://support.google.com/localservices/answer/7434558 このタイプは、 AdvertisingChannelType.LOCAL_SERVICES を使用するキャンペーンでのみサポートされます。