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

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