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

To pole jest wymagane. Zasób nadrzędny współużytkowany przez wszystkie zadania. Ta wartość musi mieć format providers/{provider}. Element provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project. Pole nadrzędne w wiadomościach CreateTaskRequest musi być puste lub musi być zgodne z tym polem.

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 skonfigurujesz to pole, pole nagłówka w wiadomościach CreateTaskRequest musi być puste lub musi pasować do tego pola.
requests[]

object (CreateTaskRequest)

To pole jest 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 Listę zadań.

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

To pole jest wymagane. Musi mieć format providers/{provider}. Element provider musi być identyfikatorem projektu Google Cloud. Na przykład: sample-cloud-project.
taskId

string

To pole jest wymagane. Identyfikator zadania musi być unikalny, ale nie może być identyfikatorem śledzenia przesyłki. Aby zapisać identyfikator śledzenia przesyłki, użyj pola trackingId. Pamiętaj, że wiele zadań może mieć ten sam element trackingId. Identyfikatory zadań podlegają tym ograniczeniom:

  • To musi być prawidłowy ciąg Unicode.
  • Maksymalna długość wynosi 64 znaki.
  • Znormalizowany zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
task

object (Task)

To pole jest wymagane. Encja zadania do utworzenia. Podczas tworzenia zadania wymagane są te pola:

  • type
  • state (musi być ustawiona na OPEN)
  • trackingId (nie można go ustawić dla zadań UNAVAILABLE ani SCHEDULED_STOP, ale wymagane w przypadku wszystkich innych typów zadań)
  • plannedLocation (opcjonalnie w przypadku UNAVAILABLE zadań)
  • taskDuration

Uwaga: pole name zadania jest ignorowane. Nie wolno ustawiać wartości żadnych innych pól z listą zadań. W przeciwnym razie zostanie zwrócony błąd.