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 kolom ini, kolom header dalam pesan CreateTaskRequest harus kosong, atau harus cocok dengan kolom ini.
requests[]

object (CreateTaskRequest)

Wajib. Pesan permintaan yang menentukan resource yang akan dibuat. Catatan: Anda dapat membuat maksimum 500 tugas dalam 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 maksimum 64 karakter.
  • Dinormalisasi sesuai dengan Unicode Normalization Form C.
  • Tidak boleh berisi salah satu karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
task

object (Task)

Wajib. Entitas Task yang akan dibuat. Saat membuat Tugas, kolom berikut diperlukan:

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

Kolom berikut dapat ditetapkan secara opsional:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

Catatan: Kolom name Tugas diabaikan. Semua kolom Tugas lainnya tidak boleh ditetapkan; jika tidak, error akan ditampilkan.