Method: providers.tasks.batchCreate

Crea y muestra un lote de objetos Task nuevos.

Solicitud HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El recurso superior que comparten todas las tareas. Este valor debe tener el formato providers/{provider}. El provider debe ser el ID del proyecto de Google Cloud. Por ejemplo, sample-cloud-project. El campo superior de los mensajes CreateTaskRequest debe estar vacío o debe coincidir con este campo.

Cuerpo de la solicitud

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

Representación JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Campos
header

object (DeliveryRequestHeader)

Opcional. El encabezado de la solicitud estándar de la API de Delivery Nota: Si estableces este campo, el campo del encabezado de los mensajes CreateTaskRequest debe estar vacío o coincidir con este.
requests[]

object (CreateTaskRequest)

Obligatorio. El mensaje de solicitud que especifica los recursos que se crearán. Nota: Puedes crear un máximo de 500 tareas por lote.

Cuerpo de la respuesta

El mensaje de respuesta BatchCreateTask.

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

Representación JSON 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Campos
tasks[]

object (Task)

Las tareas creadas

CreateTaskRequest

El mensaje de solicitud tasks.create

Representación JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Campos
header

object (DeliveryRequestHeader)

Opcional. El encabezado de la solicitud estándar de la API de Delivery
parent

string

Obligatorio. Debe tener el formato providers/{provider}. El provider debe ser el ID del proyecto de Google Cloud. Por ejemplo, sample-cloud-project.
taskId

string

Obligatorio. El ID de tarea debe ser único, pero no debe ser un ID de seguimiento de envío. Para almacenar un ID de seguimiento del envío, usa el campo trackingId. Ten en cuenta que varias tareas pueden tener el mismo trackingId. Los IDs de tarea están sujetos a las siguientes restricciones:

  • Debe ser una string Unicode válida.
  • Tiene una longitud máxima de 64 caracteres.
  • Se normalizó según el formulario de normalización C de Unicode.
  • No puede contener ninguno de los siguientes caracteres ASCII: "/", ":", "?", "," o "#".
task

object (Task)

Obligatorio. La entidad Task que se creará. Cuando se crea una tarea, se requieren los siguientes campos:

  • type
  • state (se debe establecer en OPEN)
  • trackingId (no se debe configurar para tareas de UNAVAILABLE ni SCHEDULED_STOP, pero es obligatorio para todos los demás tipos de tareas)
  • plannedLocation (opcional para UNAVAILABLE tareas)
  • taskDuration

Nota: Se ignora el campo name de la tarea. Todos los demás campos Task no se deben configurar; de lo contrario, se muestra un error.