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)

必需。要创建的 Task 实体。创建任务时，必须填写以下字段：

  • type
  • state（必须设置为 OPEN）
  • trackingId（不得为 UNAVAILABLE 或 SCHEDULED_STOP 任务设置，但所有其他任务类型必须设置）
  • plannedLocation（可选，用于 UNAVAILABLE 项任务）
  • taskDuration

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