Method: providers.tasks.batchCreate

Crea e restituisce un gruppo di nuovi oggetti Task.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. La risorsa padre condivisa da tutte le attività. Questo valore deve essere nel formato providers/{provider}. provider deve essere l'ID progetto Google Cloud. Ad esempio: sample-cloud-project. Il campo principale nei messaggi CreateTaskRequest deve essere vuoto oppure deve corrispondere a questo campo.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Campi
header

object (DeliveryRequestHeader)

Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. Nota: se imposti questo campo, il campo dell'intestazione nei messaggi CreateTaskRequest deve essere vuoto o deve corrispondere a questo campo.
requests[]

object (CreateTaskRequest)

Obbligatorio. Il messaggio di richiesta che specifica le risorse da creare. Nota: puoi creare un massimo di 500 attività in un gruppo.

Corpo della risposta

Il messaggio di risposta BatchCreateTask.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Campi
tasks[]

object (Task)

Le attività create.

CreateTaskRequest

Il messaggio di richiesta tasks.create.

Rappresentazione JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Campi
header

object (DeliveryRequestHeader)

Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard.
parent

string

Obbligatorio. Deve essere nel formato providers/{provider}. provider deve essere l'ID progetto Google Cloud. Ad esempio: sample-cloud-project.
taskId

string

Obbligatorio. L'ID attività deve essere univoco, ma non deve essere un ID monitoraggio della spedizione. Per archiviare un ID monitoraggio della spedizione, utilizza il campo trackingId. Tieni presente che più attività possono avere lo stesso trackingId. Gli ID attività sono soggetti alle seguenti limitazioni:

  • Deve essere una stringa Unicode valida.
  • Lunghezza massima: 64 caratteri.
  • Normalizzato secondo lo Unicode Normalization Form C.
  • Non può contenere i seguenti caratteri ASCII: "/", ":", "?", "," o "#".
task

object (Task)

Obbligatorio. L'entità Tasks da creare. Quando crei un'attività, i seguenti campi sono obbligatori:

  • type
  • state (deve essere impostato su OPEN)
  • trackingId (non deve essere impostato per le attività UNAVAILABLE o SCHEDULED_STOP, ma obbligatorio per tutti gli altri tipi di attività)
  • plannedLocation (facoltativa per UNAVAILABLE attività)
  • taskDuration

Nota: il campo name dell'attività viene ignorato. Tutti gli altri campi Attività non devono essere impostati, altrimenti verrà restituito un errore.