Method: providers.tasks.batchCreate

Tworzy i zwraca partię nowych obiektów Task.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Zasób nadrzędny udostępniony wszystkim zadaniom. Ta wartość musi mieć format providers/{provider}. Wartość provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project. Pole nadrzędne w wiadomościach CreateTaskRequest musi być puste lub pasować do tego pola.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Pola
header

object (DeliveryRequestHeader)

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API; Uwaga: jeśli ustawisz to pole, pole nagłówka w wiadomościach CreateTaskRequest musi być puste lub zgodne z tym polem.
requests[]

object (CreateTaskRequest)

Wymagane. Komunikat z prośbą o utworzenie zasobów. Uwaga: możesz utworzyć maksymalnie 500 zadań w ramach jednego zbiorczego zadania.

Treść odpowiedzi

wiadomość BatchCreateTask z odpowiedzią,

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Pola
tasks[]

object (Task)

Utworzone zadania.

CreateTaskRequest

wiadomość z prośbą tasks.create,

Zapis JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Pola
header

object (DeliveryRequestHeader)

Opcjonalnie: standardowy nagłówek żądania interfejsu Delivery API;
parent

string

Wymagane. Musi mieć format providers/{provider}. Wartość provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project.
taskId

string

Wymagane. Identyfikator zadania musi być unikalny, ale nie powinien być identyfikatorem śledzenia przesyłki. Aby zapisać identyfikator śledzenia przesyłki, użyj pola trackingId. Pamiętaj, że do tego samego elementu trackingId może należeć kilka zadań. Identyfikatory zadań podlegają tym ograniczeniom:

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • znormalizowany zgodnie z formą normalizacji C standardu Unicode.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
task

object (Task)

Wymagane. Encja Zadania do utworzenia. Podczas tworzenia zadania wymagane są te pola:

  • type
  • state (musi mieć wartość OPEN)
  • trackingId (nie może być ustawiony dla zadań UNAVAILABLE ani SCHEDULED_STOP, ale jest wymagany w przypadku wszystkich innych typów zadań)
  • plannedLocation (opcjonalny w przypadku zadań UNAVAILABLE)
  • taskDuration

Uwaga: pole name w zadaniu jest ignorowane. Wszystkie pozostałe pola zadania nie mogą być ustawione, w przeciwnym razie zwracany jest błąd.