Method: providers.tasks.batchCreate

创建并返回一批新的 Task 对象。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。所有任务共享的父级资源。此值必须采用 providers/{provider} 格式。provider 必须是 Google Cloud 项目 ID。例如 sample-cloud-projectCreateTaskRequest 消息中的父级字段必须为空,或者必须与此字段匹配。

请求正文

请求正文中包含结构如下的数据:

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 项目 ID。例如 sample-cloud-project

taskId

string

必需。任务 ID 必须是唯一的,但不应是配送跟踪 ID。如需存储配送跟踪 ID,请使用 trackingId 字段。请注意,多个任务可以具有相同的 trackingId。任务 ID 受限于以下限制:

  • 必须是有效的 Unicode 字符串。
  • 长度上限为 64 个字符。
  • 已根据 Unicode 标准化形式 C 进行标准化。
  • 不得包含以下任何 ASCII 字符:'/'、':'、'?'、',' 或 '#'。
task

object (Task)

必需。要创建的 Tasks 实体。创建任务时,以下字段是必填字段:

  • type
  • state(必须设置为 OPEN
  • trackingId(不得为 UNAVAILABLESCHEDULED_STOP 任务设置,但对所有其他任务类型而言都是必需的)
  • plannedLocation(对于 UNAVAILABLE 任务为可选)
  • taskDuration

注意:系统会忽略任务的 name 字段。不得设置所有其他 Task 字段;否则,系统会返回错误。