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 compartido por 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 a la API de entrega estándar. Nota: Si configuras este campo, el campo del encabezado en los mensajes de 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 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 a la API de entrega estándar.
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 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 creas una tarea, se requieren los siguientes campos:

  • type
  • state (se debe establecer en OPEN)
  • trackingId (no se debe establecer para tareas 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. No se deben configurar todos los demás campos de Task. De lo contrario, se muestra un error.