CampaignBudget

廣告活動預算。

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

無法變更。廣告活動預算的資源名稱。廣告活動預算資源名稱的格式為：

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 建立廣告活動預算時，所有明確共用的廣告活動預算都必須包含非空值且不可空白。未明確共用的廣告活動預算，取自附加廣告活動的名稱。

這個字串的長度必須介於 1 到 255 (含) 之間 (以 UTF-8 位元組為單位，已剪輯)。
amountMicros

string (int64 format)

預算金額，以帳戶的當地幣別表示。金額以百萬分之一為單位，其中一百萬等於 1 個貨幣單位。每月支出的上限為這個金額的 30.4 倍。
totalAmountMicros

string (int64 format)

預算的生命週期金額，以帳戶的當地幣別表示。金額以百萬分之一為單位，其中一百萬等於 1 個貨幣單位。
explicitlyShared

boolean

指定是否明確共用預算。如果建立作業中未指定，則預設值為 true。

如果為 true，則預算是供一或多個廣告活動共用。

如果為 false，則預算僅供單一廣告活動使用。預算的名稱和狀態會與廣告活動的名稱和狀態保持同步。如果嘗試與第二個廣告活動共用預算，就會發生錯誤。

非共用預算可設為明確共用。這項操作也必須指定預算名稱。

共用預算永遠無法非共用。
referenceCount

string (int64 format)

僅供輸出。正在使用預算的廣告活動數量。

這是唯讀欄位。
recommendedBudgetAmountMicros

string (int64 format)

僅供輸出。建議的預算金額。如果沒有可用的建議，系統會將此設為預算金額。金額以百萬分之一為單位，其中一百萬等於 1 個貨幣單位。

這是唯讀欄位。
recommendedBudgetEstimatedChangeWeeklyClicks

string (int64 format)

僅供輸出。套用建議預算後，每週點擊次數的預估變化。

這是唯讀欄位。
recommendedBudgetEstimatedChangeWeeklyCostMicros

string (int64 format)

僅供輸出。套用建議預算後，每週費用的預估變化 (以百萬分之一為單位)。一百萬等於 1 個貨幣單位。

這是唯讀欄位。
recommendedBudgetEstimatedChangeWeeklyInteractions

string (int64 format)

僅供輸出。套用建議預算後，每週互動次數的預估變化。

這是唯讀欄位。
recommendedBudgetEstimatedChangeWeeklyViews

string (int64 format)

僅供輸出。套用建議預算後，每週觀看次數的預估變化。

這是唯讀欄位。

BudgetStatus

預算可能的狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
ENABLED 預算已啟用。
REMOVED 已移除預算。

BudgetDeliveryMethod

預算可能的放送方式。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
STANDARD 預算伺服器會監控廣告在整個時段內平均放送。
ACCELERATED 預算伺服器不會監控放送作業，系統會盡快放送廣告。

BudgetPeriod

預算可能的適用期間。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
DAILY 每日預算：
CUSTOM_PERIOD 在 V5 中重新加入自訂預算。自訂預算可與 total_amount 搭配使用，藉此指定生命週期預算上限。詳情請參閱：https://support.google.com/google-ads/answer/6385083。

BudgetType

可能的預算類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
STANDARD 適用於標準 Google Ads 使用的預算類型。將每日支出上限設為指定預算金額的兩倍。瞭解詳情：https://support.google.com/google-ads/answer/6385083
FIXED_CPA

採用固定單次轉換出價 (轉換) 的預算類型。瞭解詳情：https://support.google.com/google-ads/answer/7528254

只有採用 AdvertisingChannelType.DISPLAY (不包括 AdvertisingChannelSubType.DISPLAY_廣)、出價 StrategyType.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 的廣告活動才支援這種類型。