AddBatchJobOperationsRequest

  • The AddBatchJobOperationsRequest 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.

  • A sequence_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 for BatchJobService.AddBatchJobOperations.

Fields

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.

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".