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

Tham số
parent

string

Bắt buộc. Tài nguyên mẹ dùng chung cho tất cả việc cần làm. Giá trị này phải có đị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 đề của yêu cầu API phân phối chuẩn. Lưu ý: Nếu bạn thiết lập 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 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 một lúc.

Nội dung phản hồi

Tin nhắn phản hồi của 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

Nội dung 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 đề của 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à duy nhất, nhưng không được là mã theo dõi quá trình vận chuyển. Để lưu trữ mã theo dõi gói hàng, hãy sử dụng trường trackingId. Xin lưu ý rằng nhiều tác vụ có thể có cùng trackingId. Mã việc cần làm 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 hóa theo Biểu mẫu chuẩn hóa 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ể Tasks cần tạo. Khi tạo một Việc cần làm, bạn phải điền các trường sau đây:

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

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