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 باشد. به عنوان مثال، sample-cloud-project . فیلد والد در پیام‌های 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)
}
} |
| فیلدها |
|---|
parent | string مورد نیاز. باید در قالب providers/{provider} باشد. provider باید شناسه پروژه Google Cloud باشد. به عنوان مثال، sample-cloud-project . |
taskId | string مورد نیاز. شناسه وظیفه باید منحصر به فرد باشد، اما نباید شناسه ردیابی محموله باشد. برای ذخیره شناسه رهگیری محموله، از قسمت trackingId استفاده کنید. توجه داشته باشید که چندین کار می توانند یک trackingId داشته باشند. شناسه های وظیفه مشمول محدودیت های زیر هستند: - باید یک رشته یونیکد معتبر باشد.
- حداکثر به طول 64 کاراکتر محدود شده است.
- طبق فرم C عادی سازی یونیکد نرمال شده است.
- ممکن است حاوی هیچ یک از کاراکترهای ASCII زیر نباشد: «/»، «:»، «؟»، «،»، یا «#».
|
task | object ( Task ) مورد نیاز. موجودیت وظیفه برای ایجاد. هنگام ایجاد یک Task، فیلدهای زیر مورد نیاز است: -
type -
state (باید روی OPEN تنظیم شود) -
trackingId (نباید برای کارهای UNAVAILABLE یا SCHEDULED_STOP تنظیم شود، اما برای همه انواع وظایف دیگر لازم است) -
plannedLocation (اختیاری برای کارهای UNAVAILABLE ) -
taskDuration
فیلدهای زیر را می توان به صورت اختیاری تنظیم کرد: -
targetTimeWindow -
taskTrackingViewConfig -
attributes
توجه: قسمت name Task نادیده گرفته می شود. تمام فیلدهای وظیفه دیگر نباید تنظیم شوند. در غیر این صورت، یک خطا برگردانده می شود. |
،
دسته ای از اشیاء Task جدید را ایجاد و برمی گرداند.
درخواست HTTP
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. منبع والد مشترک با همه وظایف. این مقدار باید در قالب providers/{provider} باشد. provider باید شناسه پروژه Google Cloud باشد. به عنوان مثال، sample-cloud-project . فیلد والد در پیام‌های 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)
}
} |
| فیلدها |
|---|
parent | string مورد نیاز. باید در قالب providers/{provider} باشد. provider باید شناسه پروژه Google Cloud باشد. به عنوان مثال، sample-cloud-project . |
taskId | string مورد نیاز. شناسه وظیفه باید منحصر به فرد باشد، اما نباید شناسه ردیابی محموله باشد. برای ذخیره شناسه رهگیری محموله، از قسمت trackingId استفاده کنید. توجه داشته باشید که چندین کار می توانند یک trackingId داشته باشند. شناسه های وظیفه مشمول محدودیت های زیر هستند: - باید یک رشته یونیکد معتبر باشد.
- حداکثر به طول 64 کاراکتر محدود شده است.
- طبق فرم C عادی سازی یونیکد نرمال شده است.
- ممکن است حاوی هیچ یک از کاراکترهای ASCII زیر نباشد: «/»، «:»، «؟»، «،»، یا «#».
|
task | object ( Task ) مورد نیاز. موجودیت وظیفه برای ایجاد. هنگام ایجاد یک Task، فیلدهای زیر مورد نیاز است: -
type -
state (باید روی OPEN تنظیم شود) -
trackingId (نباید برای کارهای UNAVAILABLE یا SCHEDULED_STOP تنظیم شود، اما برای همه انواع وظایف دیگر لازم است) -
plannedLocation (اختیاری برای کارهای UNAVAILABLE ) -
taskDuration
فیلدهای زیر را می توان به صورت اختیاری تنظیم کرد: -
targetTimeWindow -
taskTrackingViewConfig -
attributes
توجه: قسمت name Task نادیده گرفته می شود. تمام فیلدهای وظیفه دیگر نباید تنظیم شوند. در غیر این صورت، یک خطا برگردانده می شود. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
