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

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

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

object (DeliveryRequestHeader)

(Facoltativo) L'intestazione della richiesta dell'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 limitazioni:

  • Deve essere una stringa Unicode valida.
  • Lunghezza massima di 64 caratteri.
  • Normalizzato in base al formato di normalizzazione Unicode C.
  • Non può contenere nessuno dei seguenti caratteri ASCII: '/', ':', '?', ',' o '#'.
task

object (Task)

Obbligatorio. L'entità Task 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 le attività UNAVAILABLE)
  • taskDuration

Nota: il campo name dell'attività viene ignorato. Tutti gli altri campi Task non devono essere impostati; in caso contrario, viene restituito un errore.