Method: customers.batchJobs.mutate

更改批量作业。

抛出的错误列表：AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。要为其创建批量作业的客户的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "operation": {
    object (BatchJobOperation)
  }
}
字段
operation

object (BatchJobOperation)

必需。要对单个批量作业执行的操作。

响应正文

BatchJobService.MutateBatchJob 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "result": {
    object (MutateBatchJobResult)
  }
}
字段
result

object (MutateBatchJobResult)

mutate 的结果。

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。

BatchJobOperation

对批量作业执行的单个操作。

JSON 表示法 
{

  // Union field operation can be only one of the following:
  "create": {
    object (BatchJob)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
字段
联合字段 operation。mutate 操作。operation 只能是下列其中一项：
create

object (BatchJob)

创建操作：新的批量作业不需要任何资源名称。
remove

string

移除操作：批量作业必须尚未运行。已移除的批量作业的资源名称应采用以下格式：

customers/{customerId}/batchJobs/{batch_job_id}

MutateBatchJobResult

批量作业 mutate 的结果。

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

string

批量作业的资源名称。