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

คุณตั้งค่าฟิลด์ต่อไปนี้ได้

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

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