Method: providers.tasks.batchCreate

Erstellt einen Batch neuer Task-Objekte und gibt ihn zurück.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die übergeordnete Ressource, die von allen Aufgaben gemeinsam genutzt wird. Dieser Wert muss das Format providers/{provider} haben. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project Das übergeordnete Feld in den CreateTaskRequest-Nachrichten muss entweder leer sein oder mit diesem Feld übereinstimmen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Felder
header

object (DeliveryRequestHeader)

Optional. Der standardmäßige Anfrageheader der Delivery API Hinweis: Wenn Sie dieses Feld festlegen, muss das Headerfeld in den CreateTaskRequest-Nachrichten entweder leer sein oder mit diesem Feld übereinstimmen.
requests[]

object (CreateTaskRequest)

Erforderlich. Die Anfragenachricht, die die zu erstellenden Ressourcen angibt. Hinweis: Sie können in einem Batch maximal 500 Aufgaben erstellen.

Antworttext

Die Antwortnachricht BatchCreateTask.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Felder
tasks[]

object (Task)

Die erstellten Aufgaben.

CreateTaskRequest

Die Anfragenachricht tasks.create.

JSON-Darstellung 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Felder
header

object (DeliveryRequestHeader)

Optional. Der standardmäßige Anfrageheader der Delivery API
parent

string

Erforderlich. Muss das Format providers/{provider} haben. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project
taskId

string

Erforderlich. Die Aufgaben-ID muss eindeutig sein, sollte aber keine ID für die Sendungsverfolgung sein. Verwenden Sie zum Speichern einer Sendungsverfolgungs-ID das Feld trackingId. Mehrere Aufgaben können dieselbe trackingId haben. Aufgaben-IDs unterliegen den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Sie ist auf maximal 64 Zeichen beschränkt.
  • Nach der Unicode-Normalisierungsform C normalisiert.
  • Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
task

object (Task)

Erforderlich. Die zu erstellende Taskentität. Beim Erstellen einer Aufgabe müssen die folgenden Felder ausgefüllt werden:

  • type
  • state (muss auf OPEN festgelegt sein)
  • trackingId (darf nicht für UNAVAILABLE- oder SCHEDULED_STOP-Aufgaben festgelegt werden, ist jedoch für alle anderen Aufgabentypen erforderlich)
  • plannedLocation (optional für UNAVAILABLE Aufgaben)
  • taskDuration

Hinweis: Das Feld name der Aufgabe wird ignoriert. Alle anderen Aufgabenfelder dürfen nicht festgelegt werden. Andernfalls wird ein Fehler zurückgegeben.