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)
זה שינוי אופציונלי. כותרת הבקשה הרגילה של Delivery API.
|
taskId |
string
חובה. מזהה המשימה חייב להיות ייחודי, אבל לא מזהה לצורכי מעקב אחר משלוח. כדי לשמור מזהה לצורכי מעקב, צריך להשתמש בשדה trackingId. הערה: לכמה משימות יכול להיות אותו trackingId. מזהי המשימות כפופים להגבלות הבאות:
- חייבת להיות מחרוזת Unicode חוקית.
- מוגבלת לאורך של 64 תווים לכל היותר.
- מנורמלים בהתאם לטופס הנירמול של Unicode C.
- לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
|
גוף הבקשה
גוף הבקשה מכיל מופע של Task.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של Task.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\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)."]]
