Method: providers.tasks.batchCreate

Tworzy i zwraca grupę 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ępniany przez wszystkie zadania. Wartość musi mieć format providers/{provider}. 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 do interfejsu Delivery API. Uwaga: jeśli ustawisz to pole, pole nagłówka w wiadomościach CreateTaskRequest musi być puste lub pasować do tego pola.

requests[]

object (CreateTaskRequest)

Wymagane. Komunikat żądania określający zasoby do utworzenia. Uwaga: w grupie możesz utworzyć maksymalnie 500 zadań.

Treść odpowiedzi

Komunikat z odpowiedzią BatchCreateTask.

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 do interfejsu Delivery API.

parent

string

Wymagane. Musi mieć format providers/{provider}. 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 przechowywać identyfikator śledzenia przesyłki, użyj pola trackingId. Pamiętaj, że ten sam element trackingId może być przypisany do wielu zadań. Identyfikatory zadań podlegają tym ograniczeniom:

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

object (Task)

Wymagane. Encja Task, która ma zostać utworzona. Podczas tworzenia zadania musisz wypełnić 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 UNAVAILABLE zadań)
  • taskDuration

Uwaga: pole name zadania jest ignorowane. Żadne inne pola Zadania nie mogą być ustawione. w przeciwnym razie zwracany jest błąd.