AddBatchJobOperationsRequest

  • TheAddBatchJobOperationsRequest is used to add operations to a batch job in the Google Ads API.

  • It requires the resource name of the batch job and a list of mutate operations.

  • Asequence_token is used to enforce sequencing for subsequent requests, except for the first one.

  • Mutate operations can use negative integers as temporary IDs to handle dependencies between entities being created in the same batch job.

Request message forBatchJobService.AddBatchJobOperations.

Proto definition

Fields

mutate_operations[]

MutateOperation

Required. The list of mutates being added.

Operations can use negative integers as temp ids to signify dependencies between entities created in this batch job. For example, a customer with id = 1234 can create a campaign and an ad group in that same campaign by creating a campaign in the first operation with the resource name explicitly set to "customers/1234/campaigns/-1", and creating an ad group in the second operation with the campaign field also set to "customers/1234/campaigns/-1".

resource_name

string

Required. The resource name of the batch job.

sequence_token

string

A token used to enforce sequencing.

The first AddBatchJobOperations request for a batch job should not set sequence_token. Subsequent requests must set sequence_token to the value of next_sequence_token received in the previous AddBatchJobOperations response.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-12 UTC.