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. 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)

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

Obligatorio. Debe tener el formato providers/{provider}. 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 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ó de acuerdo con el formulario C de normalización de Unicode.
  • No puede contener ninguno de los siguientes caracteres ASCII: '/', ':', '?', ',' o '#'.
task

object (Task)

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

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