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

Es obligatorio. Es el recurso superior que comparten todas las tareas. Este valor debe tener el formato providers/{provider}. 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 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. Es el encabezado de solicitud estándar de la API de Delivery. Nota: Si estableces este campo, el campo de encabezado de los mensajes CreateTaskRequest debe estar vacío o debe coincidir con este campo.
requests[]

object (CreateTaskRequest)

Es obligatorio. Es el mensaje de solicitud que especifica los recursos que se crearán. Nota: Puedes crear un máximo de 500 tareas en un 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. Es el encabezado de solicitud estándar de la API de Delivery.
parent

string

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

string

Es obligatorio. El ID de la tarea debe ser único, pero no debe ser un ID de seguimiento del 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 tareas están sujetos a las siguientes restricciones:

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

object (Task)

Es obligatorio. La entidad Task que se creará. Cuando crees una tarea, se requerirán los siguientes campos:

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

De forma opcional, se pueden establecer los siguientes campos:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

Nota: Se ignora el campo name de la tarea. No se deben configurar los demás campos de Task. De lo contrario, se mostrará un error.