Method: customers.accountBudgetProposals.mutate

建立、更新或移除帳戶預算提案。會傳回作業狀態。

擲回錯誤清單：AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaErrorRequestErrorStringLengthError

HTTP 要求

POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。客戶的 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
欄位
operation

object (AccountBudgetProposalOperation)

必要欄位。要對個別帳戶層級預算提案執行的作業。
validateOnly

boolean

如果為 true，則驗證要求但尚未執行。系統只會傳回錯誤，而非傳回結果。

回應主體

帳戶層級預算變更作業的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
欄位
result

object (MutateAccountBudgetProposalResult)

修改的結果。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

AccountBudgetProposalOperation

提議新建帳戶層級預算，或修改/結束/移除現有預算。

JSON 表示法 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (AccountBudgetProposal)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
欄位
updateMask

string (FieldMask format)

決定修改預算欄位的欄位遮罩。儘管預算可能會修改，但提議修改後的提案皆為最終狀態。因此提案不支援更新作業。

修改預算的提案具有「更新」提案類型。為任何其他提案類型指定遮罩將視為錯誤。

此為以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。
聯集欄位 operation。修改作業。operation 只能是下列其中一項：
create

object (AccountBudgetProposal)

建立作業：建立新提案，用來建立新預算、編輯現有預算、結束有效放送的預算，或移除已排定於日後啟用的已核准預算。新提案不應包含任何資源名稱，
remove

string

移除作業：已移除提案的資源名稱，格式如下：

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}如果要求待處理，系統可能會取消要求。

MutateAccountBudgetProposalResult

帳戶預算提案的結果變化。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

傳回成功的作業。