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 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 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 im Format providers/{provider} vorliegen. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project
taskId

string

Erforderlich. Die Aufgaben-ID muss eindeutig sein, darf aber keine Sendungs-ID sein. Verwenden Sie das Feld trackingId, um eine Sendungs-Tracking-ID zu speichern. Mehrere Aufgaben können dieselbe trackingId haben. Für Aufgaben-IDs gelten die folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Ist auf eine maximale Länge von 64 Zeichen beschränkt.
  • Normalisiert gemäß Unicode-Normalisierungsform C.
  • Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.
task

object (Task)

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

  • type
  • state (muss auf OPEN gesetzt 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 sein. Andernfalls wird ein Fehler zurückgegeben.