Method: providers.tasks.batchCreate

Crea e restituisce un batch 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 del progetto Google Cloud. Ad esempio: sample-cloud-project. Il campo principale nei messaggi CreateTaskRequest deve essere vuoto o 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)

(Facoltativo) L'intestazione della richiesta API Delivery standard. Nota: se imposti questo campo, il campo di 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à per gruppo.

Corpo della risposta

Il messaggio di risposta di 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 di tasks.create.

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

object (DeliveryRequestHeader)

(Facoltativo) L'intestazione della richiesta API Delivery standard.
parent

string

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

string

Obbligatorio. L'ID attività deve essere univoco, ma non un ID di monitoraggio della spedizione. Per memorizzare 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 restrizioni:

  • Deve essere una stringa Unicode valida.
  • Lunghezza massima di 64 caratteri.
  • Normalizzato secondo lo Unicode Normalization Form C.
  • Non può contenere nessuno dei 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 (facoltativo per UNAVAILABLE attività)
  • taskDuration

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