注意: 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)` 出力のみ。推奨予算を適用した場合に見込まれる週あたりのインタラクション数の変化です。このフィールドは読み取り専用です。
`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 を指定したキャンペーンでのみ使用できます。