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ępniony wszystkim zadaniom. 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: 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 zapisać identyfikator śledzenia przesyłki, użyj pola trackingId. Pamiętaj, że ta sama wartość trackingId może występować w przypadku wielu zadań. Identyfikatory zadań podlegają tym ograniczeniom:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.
task

object (Task)

Wymagane. Encja Zadania do utworzenia. Podczas tworzenia zadania musisz wypełnić te pola:

  • type
  • state (musi mieć wartość OPEN)
  • trackingId (nie można go ustawić w przypadku 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 zadania jest ignorowane. Żadne inne pola Zadania nie mogą być ustawione. w przeciwnym razie zwracany jest błąd.