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/v14/{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. 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

Un token que se usa para aplicar la secuencia.

La primera solicitud de batchJobs.addOperations para un trabajo por lotes no debe establecer este token. Las solicitudes posteriores deben establecer secuenciaToken con el valor de nextSequenceToken recibido en la respuesta batchJobs.addOperations anterior.

mutateOperations[]

object (MutateOperation)

Obligatorio. La lista de mutaciones que se agregan.

Las operaciones pueden usar números enteros negativos como IDs temporales para indicar dependencias entre 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 configurado explícitamente como "customers/1234/campaigns/-1" y la creación de 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)

La cantidad total de operaciones agregadas hasta el momento para este trabajo por lotes.

nextSequenceToken

string

El token de secuencia que se utilizará cuando se vuelva a llamar a batchJobs.addOperations, si se deben agregar más operaciones. La siguiente solicitud batchJobs.addOperations debe establecer el campo secuenciaToken con 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 la Descripción general de OAuth 2.0.