Method: providers.tasks.batchCreate
সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন
আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।
নতুন Task অবজেক্টের একটি ব্যাচ তৈরি করে এবং ফেরত দেয়।
HTTP অনুরোধ
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
| পরামিতি |
|---|
parent | string প্রয়োজন। সমস্ত কাজের দ্বারা ভাগ করা মূল সম্পদ। এই মানটি অবশ্যই providers/{provider} ফর্ম্যাটে হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project । CreateTaskRequest বার্তাগুলির মূল ক্ষেত্রটি অবশ্যই খালি থাকতে হবে, অথবা এটি অবশ্যই এই ক্ষেত্রের সাথে মিলবে৷ |
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| ক্ষেত্র |
|---|
header | object ( DeliveryRequestHeader ) ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম। দ্রষ্টব্য: আপনি যদি এই ক্ষেত্রটি সেট করেন, তাহলে CreateTaskRequest বার্তাগুলির শিরোনাম ক্ষেত্রটি হয় খালি থাকতে হবে, অথবা এটি অবশ্যই এই ক্ষেত্রের সাথে মিলবে। |
requests[] | object ( CreateTaskRequest ) প্রয়োজন। অনুরোধ বার্তা যা তৈরি করার জন্য সংস্থানগুলি নির্দিষ্ট করে৷ দ্রষ্টব্য: আপনি একটি ব্যাচে সর্বাধিক 500টি কাজ তৈরি করতে পারেন। |
প্রতিক্রিয়া শরীর
BatchCreateTask প্রতিক্রিয়া বার্তা।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
| JSON প্রতিনিধিত্ব |
|---|
{
"tasks": [
{
object (Task)
}
]
} |
| ক্ষেত্র |
|---|
tasks[] | object ( Task ) তৈরি করা টাস্ক. |
TaskRequest তৈরি করুন
tasks.create অনুরোধ বার্তা।
| JSON প্রতিনিধিত্ব |
|---|
{
"header": {
object (DeliveryRequestHeader)
},
"parent": string,
"taskId": string,
"task": {
object (Task)
}
} |
| ক্ষেত্র |
|---|
parent | string প্রয়োজন। ফর্ম্যাট providers/{provider} হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project । |
taskId | string প্রয়োজন। টাস্ক আইডিটি অবশ্যই অনন্য হতে হবে, তবে এটি একটি শিপমেন্ট ট্র্যাকিং আইডি হওয়া উচিত নয়৷ একটি চালান ট্র্যাকিং আইডি সংরক্ষণ করতে, trackingId ক্ষেত্রটি ব্যবহার করুন৷ মনে রাখবেন যে একাধিক কাজের একই trackingId থাকতে পারে। টাস্ক আইডি নিম্নলিখিত বিধিনিষেধ সাপেক্ষে: - একটি বৈধ ইউনিকোড স্ট্রিং হতে হবে।
- সর্বাধিক 64 অক্ষরের দৈর্ঘ্যে সীমাবদ্ধ।
- ইউনিকোড নরমালাইজেশন ফর্ম সি অনুযায়ী স্বাভাবিক করা হয়েছে।
- নিম্নলিখিত ASCII অক্ষরগুলির মধ্যে কোনও নাও থাকতে পারে: '/', ':', '?', ',', বা '#'৷
|
task | object ( 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 ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project । CreateTaskRequest বার্তাগুলির মূল ক্ষেত্রটি অবশ্যই খালি থাকতে হবে, অথবা এটি অবশ্যই এই ক্ষেত্রের সাথে মিলবে৷ |
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| ক্ষেত্র |
|---|
header | object ( DeliveryRequestHeader ) ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম। দ্রষ্টব্য: আপনি যদি এই ক্ষেত্রটি সেট করেন, তাহলে CreateTaskRequest বার্তাগুলির শিরোনাম ক্ষেত্রটি হয় খালি থাকতে হবে, অথবা এটি অবশ্যই এই ক্ষেত্রের সাথে মিলবে। |
requests[] | object ( CreateTaskRequest ) প্রয়োজন। অনুরোধ বার্তা যা তৈরি করার জন্য সংস্থানগুলি নির্দিষ্ট করে৷ দ্রষ্টব্য: আপনি একটি ব্যাচে সর্বাধিক 500টি কাজ তৈরি করতে পারেন। |
প্রতিক্রিয়া শরীর
BatchCreateTask প্রতিক্রিয়া বার্তা।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
| JSON প্রতিনিধিত্ব |
|---|
{
"tasks": [
{
object (Task)
}
]
} |
| ক্ষেত্র |
|---|
tasks[] | object ( Task ) তৈরি করা টাস্ক. |
TaskRequest তৈরি করুন
tasks.create অনুরোধ বার্তা।
| JSON প্রতিনিধিত্ব |
|---|
{
"header": {
object (DeliveryRequestHeader)
},
"parent": string,
"taskId": string,
"task": {
object (Task)
}
} |
| ক্ষেত্র |
|---|
parent | string প্রয়োজন। ফর্ম্যাট providers/{provider} হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project । |
taskId | string প্রয়োজন। টাস্ক আইডিটি অবশ্যই অনন্য হতে হবে, তবে এটি একটি শিপমেন্ট ট্র্যাকিং আইডি হওয়া উচিত নয়৷ একটি চালান ট্র্যাকিং আইডি সংরক্ষণ করতে, trackingId ক্ষেত্রটি ব্যবহার করুন৷ মনে রাখবেন যে একাধিক কাজের একই trackingId থাকতে পারে। টাস্ক আইডি নিম্নলিখিত বিধিনিষেধ সাপেক্ষে: - একটি বৈধ ইউনিকোড স্ট্রিং হতে হবে।
- সর্বাধিক 64 অক্ষরের দৈর্ঘ্যে সীমাবদ্ধ।
- ইউনিকোড নরমালাইজেশন ফর্ম সি অনুযায়ী স্বাভাবিক করা হয়েছে।
- নিম্নলিখিত ASCII অক্ষরগুলির মধ্যে কোনও নাও থাকতে পারে: '/', ':', '?', ',', বা '#'৷
|
task | object ( Task ) প্রয়োজন। তৈরি করার টাস্ক সত্তা। একটি টাস্ক তৈরি করার সময়, নিম্নলিখিত ক্ষেত্রগুলি প্রয়োজন: -
type -
state ( OPEN সেট করা আবশ্যক) -
trackingId ( UNAVAILABLE বা SCHEDULED_STOP কাজের জন্য সেট করা উচিত নয়, তবে অন্যান্য সমস্ত ধরনের কাজের জন্য প্রয়োজন) -
plannedLocation ( UNAVAILABLE কাজের জন্য ঐচ্ছিক) -
taskDuration
নিম্নলিখিত ক্ষেত্রগুলি ঐচ্ছিকভাবে সেট করা যেতে পারে: -
targetTimeWindow -
taskTrackingViewConfig -
attributes
দ্রষ্টব্য: টাস্কের name ক্ষেত্রটি উপেক্ষা করা হয়েছে। অন্য সব টাস্ক ফিল্ড সেট করা উচিত নয়; অন্যথায়, একটি ত্রুটি ফেরত দেওয়া হয়। |
অন্য কিছু উল্লেখ না করা থাকলে, এই পৃষ্ঠার কন্টেন্ট Creative Commons Attribution 4.0 License-এর অধীনে এবং কোডের নমুনাগুলি Apache 2.0 License-এর অধীনে লাইসেন্স প্রাপ্ত। আরও জানতে, Google Developers সাইট নীতি দেখুন। 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. |"]]
