Method: customers.batchJobs.mutate

Muta un trabajo por lotes.

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

Solicitud HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/batchJobs:mutate

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

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente para el que se crea un trabajo por lotes.

Cuerpo de la solicitud

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

Representación JSON
{
  "operation": {
    object (BatchJobOperation)
  }
}
Campos
operation

object (BatchJobOperation)

Obligatorio. La operación que se realizará en un trabajo por lotes individual.

Cuerpo de la respuesta

Mensaje de respuesta para BatchJobService.MutateBatchJob.

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

Representación JSON
{
  "result": {
    object (MutateBatchJobResult)
  }
}
Campos
result

object (MutateBatchJobResult)

El resultado de la función {i>mutate<i}.

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.

BatchJobOperation

Una sola operación en un trabajo por lotes.

Representación JSON
{

  // Union field operation can be only one of the following:
  "create": {
    object (BatchJob)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Campos
Campo de unión operation. La operación {i>mutate<i}. Las direcciones (operation) solo pueden ser una de las siguientes opciones:
create

object (BatchJob)

Operación de creación: No se espera ningún nombre de recurso para el nuevo trabajo por lotes.

remove

string

Quitar operación: el trabajo por lotes no debe haberse ejecutado. Se espera un nombre de recurso para el trabajo por lotes que se quitó, en este formato:

customers/{customerId}/batchJobs/{batch_job_id}

MutateBatchJobResult

El resultado de la mutación del trabajo por lotes.

Representación JSON
{
  "resourceName": string
}
Campos
resourceName

string

El nombre del recurso del trabajo por lotes.