Method: providers.tasks.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ كائن Task جديدًا وتعرضه.
طلب HTTP
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. يجب أن يكون بالتنسيق providers/{provider}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project
|
معامِلات طلب البحث
| المعلمات |
header |
object (DeliveryRequestHeader)
اختياريّ. عنوان طلب Standard Delivery API
|
taskId |
string
مطلوب. يجب أن يكون معرّف المهمة فريدًا، ولكن يجب ألا يكون معرّف تتبّع شحن. لتخزين رقم تعريف تتبّع الشحن، استخدِم الحقل trackingId. يُرجى العِلم أنّه يمكن أن تتضمّن مهام متعددة سمة trackingId نفسها. تخضع معرّفات المهام للقيود التالية:
- يجب أن تكون سلسلة Unicode صالحة.
- لا يتجاوز عدد الأحرف 64 حرفًا كحد أقصى.
- تمت التسوية وفقًا لنموذج تسوية Unicode C.
- لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
|
نص الطلب
يحتوي نص الطلب على مثال Task.
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Task تم إنشاؤه حديثًا.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCreates and returns a new \u003ccode\u003eTask\u003c/code\u003e object via a \u003ccode\u003ePOST\u003c/code\u003e request to the specified URL.\u003c/p\u003e\n"],["\u003cp\u003eRequires a \u003ccode\u003eprovider\u003c/code\u003e path parameter which should be set to your Google Cloud Project ID.\u003c/p\u003e\n"],["\u003cp\u003eRequires a unique \u003ccode\u003etaskId\u003c/code\u003e query parameter and optionally accepts a \u003ccode\u003eheader\u003c/code\u003e for the Delivery API request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body and successful response body both contain an instance of \u003ccode\u003eTask\u003c/code\u003e object, detailed further in provided documentation links.\u003c/p\u003e\n"]]],[],null,["# Method: providers.tasks.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n\nCreates and returns a new `Task` object.\n\n### HTTP request\n\n`POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\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\n### Query parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `header` | `object (`[DeliveryRequestHeader](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/DeliveryRequestHeader)`)` Optional. The standard Delivery API request header. |\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\n### Request body\n\nThe request body contains an instance of [Task](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks#Task).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Task](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks#Task)."]]
