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)

建立的 Tasks。

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)

必要欄位。要建立的工作實體。建立工作時，必須提供下列欄位：

  • type
  • state (必須設為 OPEN)
  • trackingId (不得為 UNAVAILABLE 或 SCHEDULED_STOP 工作設定，但所有其他工作類型都必須設定)
  • plannedLocation (UNAVAILABLE 工作為選用)
  • taskDuration

注意：系統會忽略工作的 name 欄位。不得設定所有其他工作欄位，否則系統會傳回錯誤。