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

Wymagany. 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 musi odpowiadać temu polu.

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)

Wymagany. 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

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

string

Wymagany. Identyfikator zadania musi być niepowtarzalny, 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 to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • znormalizowany zgodnie ze specyfikacją Unicode Normalization Form C.
  • Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.
task

object (Task)

Wymagany. Encja Zadania do utworzenia. Podczas tworzenia zadania wymagane są 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

Opcjonalnie możesz ustawić te pola:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

Uwaga: pole name w zadaniu jest ignorowane. Wszystkie pozostałe pola zadania muszą być puste. W przeciwnym razie zwracany jest błąd.