Method: providers.trips.create
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת נסיעה ב-Fleet Engine ומחזירה את הנסיעה החדשה.
בקשת HTTP
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
| פרמטרים |
parent |
string
חובה. חייב להיות בפורמט providers/{provider}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
|
פרמטרים של שאילתה
| פרמטרים |
header |
object (RequestHeader)
כותרת הבקשה הרגילה של Fleet Engine.
|
tripId |
string
חובה. מזהה נסיעה ייחודי. בכפוף להגבלות הבאות:
- חייבת להיות מחרוזת Unicode חוקית.
- מוגבלת לאורך של 64 תווים לכל היותר.
- מנורמלים בהתאם לטופס הנירמול של Unicode C.
- לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
|
גוף הבקשה
גוף הבקשה מכיל מופע של Trip.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של Trip.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eThis endpoint enables the creation of a new trip within the Fleet Engine system, returning the trip details upon successful creation.\u003c/p\u003e\n"],["\u003cp\u003eThe request must be a POST request to the specified URL, including necessary path and query parameters such as provider ID and a unique trip ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain a Trip object with relevant trip details as outlined in the provided documentation.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will return the newly created Trip object, providing confirmation and details of the initiated trip.\u003c/p\u003e\n"]]],[],null,["# Method: providers.trips.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 a trip in the Fleet Engine and returns the new trip.\n\n### HTTP request\n\n`POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips`\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 Project ID (for example, `sample-cloud-project`) of the Google Cloud Project of which the service account making this call is a member. |\n\n### Query parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `header` | `object (`[RequestHeader](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/RequestHeader)`)` The standard Fleet Engine request header. |\n| `tripId` | `string` Required. Unique Trip ID. 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 [Trip](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips#Trip).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Trip](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips#Trip)."]]
