Method: providers.tasks.batchCreate

新しい Task オブジェクトのバッチを作成して返します。

HTTP リクエスト

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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)

必須。作成するタスク エンティティ。タスクを作成する際、次のフィールドは必須です。

  • type
  • state（OPEN に設定する必要があります）
  • trackingId（UNAVAILABLE タスクまたは SCHEDULED_STOP タスクには設定しないでください。他のすべてのタスクタイプでは必須です）
  • plannedLocation（UNAVAILABLE タスクの場合は省略可）
  • taskDuration

次のフィールドは必要に応じて設定できます。

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

注: Task の name フィールドは無視されます。他のすべての Task フィールドは設定しないでください。設定すると、エラーが返されます。