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 Normalization Form C 進行正規化。
  • 不得包含下列任何 ASCII 字元：'/'、':'、'?'、',' 或 '#'。
task

object (Task)

必要欄位。要建立的 Task 實體。建立工作時，必須填入下列欄位：

  • type
  • state (必須設為 OPEN)
  • trackingId (請勿為 UNAVAILABLE 或 SCHEDULED_STOP 工作項設定，但其他工作項類型都需要設定)
  • plannedLocation (UNAVAILABLE 工作選用)
  • taskDuration

您可以選擇設定下列欄位：

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

注意：系統會忽略 Task 的 name 欄位。請勿設定其他 Task 欄位，否則系統會傳回錯誤。