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)

Tasks ที่สร้าง

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
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้: '/', ':', '?', ',' หรือ '#'
task

object (Task)

ต้องระบุ เอนทิตีงานที่จะสร้าง เมื่อสร้างงาน คุณต้องระบุข้อมูลในช่องต่อไปนี้

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

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