Method: customers.batchJobs.addOperations

向批量作业添加操作。

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

HTTP 请求

POST https://googleads.googleapis.com/v17/{resourceName=customers/*/batchJobs/*}:addOperations

网址采用 gRPC 转码语法。

路径参数

参数
resourceName

string

必需。批量作业的资源名称。

请求正文

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

JSON 表示法 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
字段
sequenceToken

string

用于强制执行序列的令牌。

批量作业的第一个 batchJobs.addOperations 请求不应设置序列令牌。后续请求必须将 orderToken 设为在先前 batchJobs.addOperations 响应中收到的 nextSequenceToken 的值。
mutateOperations[]

object (MutateOperation)

必需。要添加的 mutate 列表。

操作可以使用负整数作为临时 ID，以表明在此批量作业中创建的实体之间的依赖关系。例如，ID 为 1234 的客户可以在同一广告系列中同时制作广告系列和广告组，方法是在第一项操作中将资源名称明确设置为“customers/1234/campaigns/-1”，然后在第二次操作中创建一个广告组，将广告系列字段也设置为“customers/1234/campaigns/-1”。

响应正文

BatchJobService.AddBatchJobOperations 的响应消息。

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

JSON 表示法 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
字段
totalOperations

string (int64 format)

到目前为止为此批量作业添加的操作总数。
nextSequenceToken

string

需要添加更多操作时，再次调用 batchJobs.addOperations 时使用的序列令牌。下一个 batchJobs.addOperations 请求必须将 orderToken 字段设置为此字段的值。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 概览。