Method: providers.tasks.batchCreate

สร้างและส่งคืนกลุ่มออบเจ็กต์ Task ใหม่

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ ทรัพยากรระดับบนสุดที่งานทั้งหมดแชร์ ค่านี้ต้องอยู่ในรูปแบบ providers/{provider} provider ต้องเป็นรหัสโปรเจ็กต์ Google Cloud เช่น sample-cloud-project ช่องระดับบนสุดในข้อความ CreateTaskRequest ต้องว่างเปล่าหรือต้องตรงกับช่องนี้

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
ช่อง
header

object (DeliveryRequestHeader)

ไม่บังคับ ส่วนหัวของคำขอ Delivery API มาตรฐาน หมายเหตุ: ถ้าคุณตั้งค่าช่องนี้ ช่องส่วนหัวในข้อความ CreateTaskRequest จะต้องว่างเปล่าหรือต้องตรงกับช่องนี้
requests[]

object (CreateTaskRequest)

ต้องระบุ ข้อความคำขอที่ระบุทรัพยากรที่จะสร้าง หมายเหตุ: คุณสร้างงานเป็นกลุ่มได้สูงสุด 500 งาน

เนื้อหาการตอบกลับ

ข้อความตอบกลับ BatchCreateTask

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
ช่อง
tasks[]

object (Task)

งานที่สร้างขึ้น

CreateTaskRequest

ข้อความคำขอ tasks.create

การแสดง JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
ช่อง
header

object (DeliveryRequestHeader)

ไม่บังคับ ส่วนหัวของคำขอ Delivery API มาตรฐาน
parent

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider} provider ต้องเป็นรหัสโปรเจ็กต์ Google Cloud เช่น sample-cloud-project
taskId

string

ต้องระบุ โดยรหัสงานต้องไม่ซ้ำกัน แต่ไม่ควรเป็นรหัสติดตามการจัดส่ง หากต้องการจัดเก็บรหัสติดตามการจัดส่ง ให้ใช้ช่อง trackingId โปรดทราบว่างานหลายรายการมี trackingId เดียวกันได้ รหัสงานมีข้อจำกัดต่อไปนี้

  • ต้องเป็นสตริง Unicode ที่ถูกต้อง
  • จำกัดให้มีความยาวสูงสุด 64 อักขระ
  • ได้รับการปรับให้เป็นมาตรฐานตามแบบฟอร์มการปรับมาตรฐาน Unicode C
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้: "/", ":", "?", "," หรือ "#"
task

object (Task)

ต้องระบุ เอนทิตีงานที่จะสร้าง เมื่อสร้างงาน คุณต้องระบุฟิลด์ต่อไปนี้

  • type
  • state (ต้องตั้งค่าเป็น OPEN)
  • trackingId (ต้องไม่ตั้งค่าสำหรับงาน UNAVAILABLE หรือ SCHEDULED_STOP แต่จำเป็นสำหรับงานประเภทอื่นๆ ทั้งหมด)
  • plannedLocation (ไม่บังคับสำหรับ UNAVAILABLE งาน)
  • taskDuration

หมายเหตุ: ระบบจะไม่สนใจช่อง name ของงาน ต้องไม่ตั้งค่าช่องงานอื่นๆ ทั้งหมด มิเช่นนั้นระบบจะแสดงข้อผิดพลาด