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 principale 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 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 progetto Google Cloud. Ad esempio: sample-cloud-project.
taskId

string

Obbligatorio. L'ID attività deve essere univoco, ma non deve essere un ID tracciabilità 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.
  • Sono consentiti massimo 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

Se vuoi, puoi impostare i seguenti campi:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

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