Method: customers.batchJobs.addOperations

Agrega operaciones al trabajo por lotes.

Lista de errores arrojados: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
resourceName

string

Obligatorio. Es el nombre del recurso del trabajo por lotes.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Campos
sequenceToken

string

Es un token que se usa para aplicar la secuenciación.

La primera solicitud batchJobs.addOperations para un trabajo por lotes no debe establecer sequenceToken. Las solicitudes posteriores deben establecer sequenceToken en el valor de nextSequenceToken recibido en la respuesta anterior de batchJobs.addOperations.
mutateOperations[]

object (MutateOperation)

Obligatorio. La lista de mutaciones que se agregarán.

Las operaciones pueden usar números enteros negativos como IDs temporales para indicar dependencias entre las entidades creadas en este trabajo por lotes. Por ejemplo, un cliente con el ID = 1234 puede crear una campaña y un grupo de anuncios en esa misma campaña. Para ello, debe crear una campaña en la primera operación con el nombre del recurso establecido explícitamente en "customers/1234/campaigns/-1" y crear un grupo de anuncios en la segunda operación con el campo de campaña también establecido en "customers/1234/campaigns/-1".

Cuerpo de la respuesta

Mensaje de respuesta para BatchJobService.AddBatchJobOperations.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Campos
totalOperations

string (int64 format)

Es la cantidad total de operaciones agregadas hasta el momento para este trabajo por lotes.
nextSequenceToken

string

Es el token de secuencia que se usará cuando se vuelva a llamar a batchJobs.addOperations si se deben agregar más operaciones. La siguiente solicitud batchJobs.addOperations debe establecer el campo sequenceToken en el valor de este campo.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.