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)

選用設定。Standard 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)

選用設定。Standard 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

注意：Task 的 name 欄位會遭到忽略。您不得設定所有其他的 Task 欄位，否則會傳回錯誤。