Method: providers.tasks.batchCreate

Yeni Task nesneleri grubu oluşturur ve döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Tüm görevler tarafından paylaşılan üst kaynak. Bu değer providers/{provider} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project. CreateTaskRequest mesajlarındaki üst alan boş olmalı veya bu alanla eşleşmelidir.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Alanlar
header

object (DeliveryRequestHeader)

İsteğe bağlı. Standart Delivery API isteği başlığı. Not: Bu alanı ayarlarsanız CreateTaskRequest iletilerindeki üstbilgi alanı boş veya bu alanla eşleşmelidir.

requests[]

object (CreateTaskRequest)

Zorunlu. Oluşturulacak kaynakları belirten istek mesajı. Not: Bir toplu işlemde en fazla 500 görev oluşturabilirsiniz.

Yanıt gövdesi

BatchCreateTask yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Alanlar
tasks[]

object (Task)

Oluşturulan Görevler.

CreateTaskRequest

tasks.create istek mesajı.

JSON gösterimi
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Alanlar
header

object (DeliveryRequestHeader)

İsteğe bağlı. Standart Delivery API isteği başlığı.

parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.

taskId

string

Zorunlu. Görev kimliği benzersiz olmalı ancak gönderi takip kimliği olmamalıdır. Gönderim izleme kimliğini saklamak için trackingId alanını kullanın. Birden fazla görevde aynı trackingId bulunabilir. Görev kimlikleri aşağıdaki kısıtlamalara tabidir:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiçbirini içeremez: "/", ":", "?", ", veya "#".
task

object (Task)

Zorunlu. Oluşturulacak görev varlığı. Görev oluştururken aşağıdaki alanların doldurulması zorunludur:

  • type
  • state (OPEN olarak ayarlanmalıdır)
  • trackingId (UNAVAILABLE veya SCHEDULED_STOP görevler için ayarlanmamalı ancak diğer tüm görev türleri için zorunludur)
  • plannedLocation (UNAVAILABLE görev için isteğe bağlı)
  • taskDuration

Not: Görevin name alanı yoksayılır. Diğer tüm Görev alanları ayarlanmamalıdır; aksi takdirde bir hata döndürülür.