Method: providers.tasks.batchCreate

Yeni bir Task nesnesi grubu oluşturup 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 iletilerindeki üst alan boş olmalı veya bu alanla eşleşmelidir.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

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

object (DeliveryRequestHeader)

İsteğe bağlı. Standart Delivery API istek başlığı. Not: Bu alanı ayarlarsanız CreateTaskRequest iletilerindeki üstbilgi alanı boş olmalı 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 istek 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ıdır ancak gönderi takip kimliği olmamalıdır. Gönderi takip kimliğini saklamak için trackingId alanını kullanın. Birden fazla görevin aynı trackingId değerine sahip olabileceğini unutmayın. 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ştirilmiştir.
  • Aşağıdaki ASCII karakterlerinden hiçbirini içeremez: '/', ':', '?', ',' veya '#'.
task

object (Task)

Zorunlu. Oluşturulacak Task öğesi. Görev oluştururken aşağıdaki alanlar gereklidir:

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

Not: Görev'in name alanı yoksayılır. Diğer tüm Görev alanları ayarlanmamalıdır. Aksi takdirde hata döndürülür.