Method: providers.tasks.batchCreate

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

object (CreateTaskRequest)

Erforderlich. Die Anfragenachricht, in der die zu erstellenden Ressourcen angegeben sind. 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 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 im Format providers/{provider} vorliegen. provider muss die Google Cloud-Projekt-ID sein. Beispiel: sample-cloud-project
taskId

string

Erforderlich. Die Aufgabe muss eine eindeutige ID haben, 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 Aufgabe. Beim Erstellen einer Aufgabe sind die folgenden Felder erforderlich:

  • type
  • state (muss auf OPEN gesetzt sein)
  • trackingId (muss 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

Die folgenden Felder können optional festgelegt werden:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

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