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-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 项目 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（不得为 UNAVAILABLE 或 SCHEDULED_STOP 任务设置，但对所有其他任务类型而言都是必需的）
  • plannedLocation（对于 UNAVAILABLE 任务为可选）
  • taskDuration

您可以选择性地设置以下字段：

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

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