Method: providers.tasks.batchCreate

Tạo và trả về một loạt đối tượng Task mới.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Tài nguyên mẹ được tất cả tác vụ chia sẻ. Giá trị này phải ở định dạng providers/{provider}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project. Trường mẹ trong thông báo CreateTaskRequest phải trống hoặc phải khớp với trường này.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Trường
header

object (DeliveryRequestHeader)

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn. Lưu ý: Nếu bạn đặt trường này, thì trường tiêu đề trong thông báo CreateTaskRequest phải để trống hoặc phải khớp với trường này.
requests[]

object (CreateTaskRequest)

Bắt buộc. Thông báo yêu cầu chỉ định các tài nguyên cần tạo. Lưu ý: Bạn có thể tạo tối đa 500 việc cần làm trong một lô.

Nội dung phản hồi

Thông báo phản hồi BatchCreateTask.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Trường
tasks[]

object (Task)

Các việc cần làm đã tạo.

CreateTaskRequest

Thông báo yêu cầu tasks.create.

Biểu diễn dưới dạng JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Trường
header

object (DeliveryRequestHeader)

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.
taskId

string

Bắt buộc. Mã công việc phải là mã duy nhất, nhưng không được là mã vận đơn. Để lưu trữ mã vận đơn, hãy sử dụng trường trackingId. Xin lưu ý rằng nhiều tác vụ có thể có cùng một trackingId. Mã công việc phải tuân theo các quy định hạn chế sau:

  • Phải là một chuỗi Unicode hợp lệ.
  • Giới hạn độ dài tối đa là 64 ký tự.
  • Được chuẩn hoá theo Unicode Normalization Form C (Biểu mẫu chuẩn hoá Unicode C).
  • Không được chứa bất kỳ ký tự ASCII nào sau đây: '/', ':', '?', ',' hoặc '#'.
task

object (Task)

Bắt buộc. Thực thể Task (Việc cần làm) cần tạo. Khi tạo một Việc cần làm, bạn phải điền vào các trường sau:

  • type
  • state (phải được đặt thành OPEN)
  • trackingId (không được đặt cho các tác vụ UNAVAILABLE hoặc SCHEDULED_STOP, nhưng bắt buộc đối với tất cả các loại tác vụ khác)
  • plannedLocation (không bắt buộc đối với các tác vụ UNAVAILABLE)
  • taskDuration

Bạn có thể tuỳ ý đặt các trường sau:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

Lưu ý: Trường name của Task (Tác vụ) sẽ bị bỏ qua. Bạn không được đặt tất cả các trường Việc cần làm khác; nếu không, hệ thống sẽ trả về lỗi.