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 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 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 Standard-Anfrageheader der Delivery API. Hinweis: Wenn Sie dieses Feld festlegen, muss das Header-Feld in den CreateTaskRequest-Nachrichten entweder leer oder mit diesem Feld übereinstimmen.
requests[]

object (CreateTaskRequest)

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

Antworttext

Die BatchCreateTask-Antwortnachricht.

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

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

object (Task)

Die erstellten Tasks.

CreateTaskRequest

Die tasks.create-Anfragenachricht.

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

object (DeliveryRequestHeader)

Optional. Der Standard-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, darf aber keine Sendungsverfolgungs-ID sein. Verwenden Sie das Feld trackingId, um eine Sendungsverfolgungs-ID zu speichern. Beachten Sie, dass mehrere Aufgaben dieselbe trackingId haben können. Aufgaben-IDs unterliegen den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Er ist auf maximal 64 Zeichen begrenzt.
  • Normalisiert nach der Unicode-Normalisierungsform C.
  • Darf keine der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
task

object (Task)

Erforderlich. Die zu erstellende Task-Entität. Beim Erstellen einer Aufgabe sind die folgenden Felder erforderlich:

  • type
  • state (muss auf OPEN festgelegt sein)
  • trackingId (darf nicht für UNAVAILABLE- oder SCHEDULED_STOP-Aufgaben festgelegt werden, ist aber 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.