Method: customers.accountBudgetProposals.mutate

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

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

HTTP 要求

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

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

路徑參數

參數
customerId

string

必要欄位。客戶的 ID。

要求主體

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

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

object (AccountBudgetProposalOperation)

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

validateOnly

boolean

如果為 true,表示要求會完成驗證,但尚未執行。系統只會傳回錯誤,不會傳回結果。

回應主體

帳戶層級預算 mut 作業的回覆訊息。

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

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)

FieldMask,用於決定要修改哪些預算欄位。雖然預算可以修改,但提出此類修改的提案為最終版本。因此提案不支援更新作業。

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

此為以半形逗號分隔的完整欄位名稱清單,範例:"user.displayName,photo"

聯集欄位 operation。修改作業。operation 只能是下列其中一項:
create

object (AccountBudgetProposal)

建立作業:新增提案,包括建立新預算、修改現有預算、結束目前使用中的預算,或移除已核准的預算 (排定於未來生效)。新提案不需要任何資源名稱。

remove

string

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

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}如果要求處於待處理狀態,可能就會取消。

MutateAccountBudgetProposalResult

帳戶預算提案的結果發生變動。

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

string

如果作業成功,系統會傳回。