向批量作业添加操作。
抛出的错误列表:AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
HTTP 请求
POST https://googleads.googleapis.com/v14/{resourceName=customers/*/batchJobs/*}:addOperations
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
resourceName |
必需。批量作业的资源名称。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
字段 | |
---|---|
sequenceToken |
用于强制执行排序的令牌。 批量作业的第一个 batchJobs.addOperations 请求不应设置 sequenceToken。后续请求必须将 orderToken 设置为在上一个 batchJobs.addOperations 响应中收到的 nextSequenceToken 的值。 |
mutateOperations[] |
必需。要添加的 mutate 的列表。 操作可以使用负整数作为临时 ID,用于表示在此批量作业中创建的实体之间的依赖关系。例如,ID = 1234 的客户可以在同一广告系列中制作广告系列和广告组,方法是在第一次操作中创建一个广告系列,将资源名称明确设置为“customers/1234/campaigns/-1”,在第二项操作中创建一个广告组,广告系列字段也设置为“customers/1234/campaigns/-1”。 |
响应正文
BatchJobService.AddBatchJobOperations
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "totalOperations": string, "nextSequenceToken": string } |
字段 | |
---|---|
totalOperations |
到目前为止,为此批量作业添加的操作总数。 |
nextSequenceToken |
需要添加更多操作时,再次调用 batchJobs.addOperations 时要使用的序列令牌。下一个 batchJobs.addOperations 请求必须将 orderToken 字段设置为此字段的值。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。