Method: customers.accountBudgetProposals.mutate

创建、更新或移除账号预算提案。返回操作状态。

抛出的错误的列表：AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaErrorRequestErrorStringLengthError

HTTP 请求

POST https://googleads.googleapis.com/v17/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)

用于确定修改哪些预算字段的 FieldMask。虽然预算可以修改，但提议此类修改的提议为最终提议。因此，不支持对提案执行更新操作。

修改预算的提案会有“更新”字样提案类型。为任何其他提案类型指定掩码将被视为错误。

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。
联合字段 operation。Mutate 操作。operation 只能是下列其中一项：
create

object (AccountBudgetProposal)

创建操作：用于创建新预算、修改现有预算、终止正在投放的预算或移除安排在未来启用的已批准预算的新提案。新提案不需要指定资源名称。
remove

string

移除操作：已移除提案的资源名称应采用以下格式：

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}如果请求处于待处理状态，则可以取消该请求。

MutateAccountBudgetProposalResult

账号预算提案的结果发生变化。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

操作成功时返回。