Method: providers.tasks.batchCreate
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает и возвращает пакет новых объектов Task .
HTTP-запрос
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Родительский ресурс, общий для всех задач. Это значение должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project . Родительское поле в сообщениях CreateTaskRequest должно быть либо пустым, либо соответствовать этому полю. |
Тело запроса
Тело запроса содержит данные следующей структуры:
| Поля |
|---|
header | object ( DeliveryRequestHeader ) Необязательный. Стандартный заголовок запроса 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)
}
} |
| Поля |
|---|
parent | string Необходимый. Должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project . |
taskId | string Необходимый. Идентификатор задачи должен быть уникальным, но не должен быть идентификатором отслеживания отправления. Чтобы сохранить идентификатор отслеживания отправления, используйте поле trackingId . Обратите внимание, что несколько задач могут иметь один и тот же trackingId . На идентификаторы задач распространяются следующие ограничения: - Должна быть допустимой строкой Unicode.
- Ограничена максимальной длиной в 64 символа.
- Нормализовано в соответствии с формой нормализации Unicode C.
- Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».
|
task | object ( Task ) Необходимый. Сущность Task, которую необходимо создать. При создании Задачи обязательны следующие поля: -
type -
state (должно быть установлено на OPEN ) -
trackingId (не должен быть установлен для задач UNAVAILABLE или SCHEDULED_STOP , но необходим для всех остальных типов задач) -
plannedLocation (необязательно для UNAVAILABLE задач) -
taskDuration
Следующие поля могут быть установлены опционально: -
targetTimeWindow -
taskTrackingViewConfig -
attributes
Примечание. Поле name задачи игнорируется. Все остальные поля задачи не должны быть заданы; в противном случае возвращается ошибка. |
,
Создает и возвращает пакет новых объектов Task .
HTTP-запрос
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Родительский ресурс, общий для всех задач. Это значение должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project . Родительское поле в сообщениях CreateTaskRequest должно быть либо пустым, либо соответствовать этому полю. |
Тело запроса
Тело запроса содержит данные следующей структуры:
| Поля |
|---|
header | object ( DeliveryRequestHeader ) Необязательный. Стандартный заголовок запроса 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)
}
} |
| Поля |
|---|
parent | string Необходимый. Должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project . |
taskId | string Необходимый. Идентификатор задачи должен быть уникальным, но не должен быть идентификатором отслеживания отправления. Чтобы сохранить идентификатор отслеживания отправления, используйте поле trackingId . Обратите внимание, что несколько задач могут иметь один и тот же trackingId . На идентификаторы задач распространяются следующие ограничения: - Должна быть допустимой строкой Unicode.
- Ограничена максимальной длиной в 64 символа.
- Нормализовано в соответствии с формой нормализации Unicode C.
- Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».
|
task | object ( Task ) Необходимый. Сущность Task, которую необходимо создать. При создании Задачи обязательны следующие поля: -
type -
state (должно быть установлено на OPEN ) -
trackingId (не должен быть установлен для задач UNAVAILABLE или SCHEDULED_STOP , но необходим для всех остальных типов задач) -
plannedLocation (необязательно для UNAVAILABLE задач) -
taskDuration
Следующие поля могут быть установлены опционально: -
targetTimeWindow -
taskTrackingViewConfig -
attributes
Примечание. Поле name задачи игнорируется. Все остальные поля задачи не должны быть заданы; в противном случае возвращается ошибка. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eCreates up to 500 \u003ccode\u003eTask\u003c/code\u003e objects at once using the \u003ccode\u003eBatchCreateTasks\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eRequires a \u003ccode\u003eparent\u003c/code\u003e resource in the URL path, indicating the Google Cloud Project ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes an optional \u003ccode\u003eheader\u003c/code\u003e and a required list of \u003ccode\u003erequests\u003c/code\u003e, each defining a \u003ccode\u003eTask\u003c/code\u003e to create.\u003c/p\u003e\n"],["\u003cp\u003eThe response returns a list of created \u003ccode\u003eTask\u003c/code\u003e objects within the \u003ccode\u003etasks\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eEach individual \u003ccode\u003eCreateTaskRequest\u003c/code\u003e requires a \u003ccode\u003etaskId\u003c/code\u003e, \u003ccode\u003etype\u003c/code\u003e, \u003ccode\u003estate\u003c/code\u003e, \u003ccode\u003etrackingId\u003c/code\u003e, and other relevant fields depending on the task type.\u003c/p\u003e\n"]]],["This document details how to create a batch of `Task` objects via a `POST` HTTP request to `https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate`. The `parent` path parameter is required and specifies the provider. The request body should contain a `header` and an array of `requests`, where each request includes a `CreateTaskRequest`. Each `CreateTaskRequest` requires a `parent`, `taskId`, and a `task` entity with specific fields. The response body returns an array of the created `Task` objects.\n"],null,["# Method: providers.tasks.batchCreate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BatchCreateTasksResponse.SCHEMA_REPRESENTATION)\n- [CreateTaskRequest](#CreateTaskRequest)\n - [JSON representation](#CreateTaskRequest.SCHEMA_REPRESENTATION)\n\nCreates and returns a batch of new `Task` objects.\n\n### HTTP request\n\n`POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource shared by all tasks. This value must be in the format `providers/{provider}`. The `provider` must be the Google Cloud Project ID. For example, `sample-cloud-project`. The parent field in the `CreateTaskRequest` messages must either be empty, or it must match this field. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"header\": { object (/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/DeliveryRequestHeader) }, \"requests\": [ { object (/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks/batchCreate#CreateTaskRequest) } ] } ``` |\n\n| Fields ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `header` | `object (`[DeliveryRequestHeader](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/DeliveryRequestHeader)`)` Optional. The standard Delivery API request header. Note: If you set this field, then the header field in the `CreateTaskRequest` messages must either be empty, or it must match this field. |\n| `requests[]` | `object (`[CreateTaskRequest](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks/batchCreate#CreateTaskRequest)`)` Required. The request message that specifies the resources to create. Note: You can create a maximum of 500 tasks in a batch. |\n\n### Response body\n\nThe `BatchCreateTask` response message.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"tasks\": [ { object (/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks#Task) } ] } ``` |\n\n| Fields ||\n|-----------|--------------------------------------------------------------------------------------------------------------------------------|\n| `tasks[]` | `object (`[Task](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks#Task)`)` The created Tasks. |\n\nCreateTaskRequest\n-----------------\n\nThe `tasks.create` request message.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"header\": { object (/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/DeliveryRequestHeader) }, \"parent\": string, \"taskId\": string, \"task\": { object (/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks#Task) } } ``` |\n\n| Fields ||\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `header` | `object (`[DeliveryRequestHeader](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/DeliveryRequestHeader)`)` Optional. The standard Delivery API request header. |\n| `parent` | `string` Required. Must be in the format `providers/{provider}`. The `provider` must be the Google Cloud Project ID. For example, `sample-cloud-project`. |\n| `taskId` | `string` Required. The Task ID must be unique, but it should be not a shipment tracking ID. To store a shipment tracking ID, use the `trackingId` field. Note that multiple tasks can have the same `trackingId`. Task IDs are subject to the following restrictions: - Must be a valid Unicode string. - Limited to a maximum length of 64 characters. - Normalized according to [Unicode Normalization Form C](http://www.unicode.org/reports/tr15/). - May not contain any of the following ASCII characters: '/', ':', '?', ',', or '#'. |\n| `task` | `object (`[Task](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks#Task)`)` Required. The Task entity to create. When creating a Task, the following fields are required: - `type` - `state` (must be set to `OPEN`) - `trackingId` (must not be set for `UNAVAILABLE` or `SCHEDULED_STOP` tasks, but required for all other task types) - `plannedLocation` (optional for `UNAVAILABLE` tasks) - `taskDuration` The following fields can be optionally set: - `targetTimeWindow` - `taskTrackingViewConfig` - `attributes` Note: The Task's `name` field is ignored. All other Task fields must not be set; otherwise, an error is returned. |"]]
