Method: providers.tasks.batchCreate

Membuat dan menampilkan batch objek Task baru.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Resource induk yang digunakan bersama oleh semua tugas. Nilai ini harus dalam format providers/{provider}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project. Kolom induk dalam pesan CreateTaskRequest harus kosong, atau harus cocok dengan kolom ini.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Kolom
header

object (DeliveryRequestHeader)

Opsional. Header permintaan Delivery API standar. Catatan: Jika Anda menetapkan bidang ini, maka bidang header dalam pesan CreateTaskRequest harus kosong, atau harus cocok dengan bidang ini.

requests[]

object (CreateTaskRequest)

Wajib. Pesan permintaan yang menentukan resource yang akan dibuat. Catatan: Anda dapat membuat maksimum 500 tugas dalam satu batch.

Isi respons

Pesan respons BatchCreateTask.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Kolom
tasks[]

object (Task)

Tugas yang dibuat.

CreateTaskRequest

Pesan permintaan tasks.create.

Representasi JSON
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Kolom
header

object (DeliveryRequestHeader)

Opsional. Header permintaan Delivery API standar.

parent

string

Wajib. Harus dalam format providers/{provider}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.

taskId

string

Wajib. ID Tugas harus unik, tetapi tidak boleh berupa ID pelacakan pengiriman. Untuk menyimpan ID pelacakan pengiriman, gunakan kolom trackingId. Perhatikan bahwa beberapa tugas dapat memiliki trackingId yang sama. ID tugas tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalkan menurut Formulir Normalisasi Unicode C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
task

object (Task)

Wajib. Entitas Tugas yang akan dibuat. Saat membuat Tugas, kolom berikut wajib diisi:

  • type
  • state (harus ditetapkan ke OPEN)
  • trackingId (tidak boleh ditetapkan untuk tugas UNAVAILABLE atau SCHEDULED_STOP, tetapi diperlukan untuk semua jenis tugas lainnya)
  • plannedLocation (opsional untuk UNAVAILABLE tugas)
  • taskDuration

Catatan: Kolom name Tugas diabaikan. Semua kolom Tugas lainnya tidak boleh ditetapkan; jika tidak, pesan {i>error<i} akan muncul.