Method: providers.tasks.batchCreate

Bir grup yeni Task nesnesi 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 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 görevde 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 kargo takip kimliği olmamalıdır. Kargo takip kimliğini saklamak için trackingId alanını kullanın. Birden çok görevin aynı trackingId öğesine 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ö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.