Method: providers.billableTrips.report
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
דיווח על שימוש בנסיעות לחיוב.
בקשת HTTP
POST https://fleetengine.googleapis.com/v1/{name=providers/*/billableTrips/*}:report
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
name |
string
חובה. הפורמט הנדרש הוא providers/{provider}/billableTrips/{billable_trip}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של פרויקט Google Cloud שבו חשבון השירות שמבצע את הקריאה הזו הוא חבר.
|
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| שדות |
countryCode |
string
חובה. קוד מדינה בן שתי אותיות של המדינה שבה מתבצעת הנסיעה. המחיר מוגדר לפי קוד המדינה.
|
platform |
enum (BillingPlatformIdentifier)
הפלטפורמה שבה הבקשה הוגשה.
|
relatedIds[] |
string
המזהים שקשורים ישירות לנסיעה שמדווחים עליה. בדרך כלל מדובר במזהים (לדוגמה, מזהי סשנים) של פעולות שבוצעו לפני ההזמנה, לפני שמזהה הנסיעה זמין. מספר ה-relatedIds מוגבל ל-50.
|
solutionType |
enum (SolutionType)
סוג הפתרון של מוצר GMP (למשל, ON_DEMAND_RIDESHARING_AND_DELIVERIES) ששימש לנסיעה שדווחה.
|
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.
SolutionType
בורר לסוגי פתרונות שונים של נסיעה שדווחה.
| טיפוסים בני מנייה (enum) |
SOLUTION_TYPE_UNSPECIFIED |
ערך ברירת המחדל. כדי לשמור על תאימות לאחור, ה-API ישתמש ב-ON_DEMAND_RIDESHARING_AND_DELIVERIES כברירת מחדל, שהוא סוג הפתרון הראשון שנתמך. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
הפתרון הוא נסיעה משותפת ומשלוח על פי דרישה. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eReport billable trip usage to Fleet Engine using the \u003ccode\u003ereport\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires the country code, platform, related IDs (optional), and solution type for the trip.\u003c/p\u003e\n"],["\u003cp\u003eSpecify the provider and billable trip in the URL path.\u003c/p\u003e\n"],["\u003cp\u003eThe response is an empty JSON object upon successful reporting.\u003c/p\u003e\n"],["\u003cp\u003eBillingPlatformIdentifier and SolutionType enums provide standardized values for specifying request platform and trip type.\u003c/p\u003e\n"]]],[],null,["# Method: providers.billableTrips.report\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- [BillingPlatformIdentifier](#BillingPlatformIdentifier)\n- [SolutionType](#SolutionType)\n\nReport billable trip usage.\n\n### HTTP request\n\n`POST https://fleetengine.googleapis.com/v1/{name=providers/*/billableTrips/*}:report`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Must be in the format `providers/{provider}/billableTrips/{billable_trip}`. 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### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"countryCode\": string, \"platform\": enum (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.billableTrips/report#BillingPlatformIdentifier), \"relatedIds\": [ string ], \"solutionType\": enum (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.billableTrips/report#SolutionType) } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `countryCode` | `string` Required. Two letter country code of the country where the trip takes place. Price is defined according to country code. |\n| `platform` | `enum (`[BillingPlatformIdentifier](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.billableTrips/report#BillingPlatformIdentifier)`)` The platform upon which the request was issued. |\n| `relatedIds[]` | `string` The identifiers that are directly related to the trip being reported. These are usually IDs (for example, session IDs) of pre-booking operations done before the trip ID is available. The number of `relatedIds` is limited to 50. |\n| `solutionType` | `enum (`[SolutionType](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.billableTrips/report#SolutionType)`)` The type of GMP product solution (for example, `ON_DEMAND_RIDESHARING_AND_DELIVERIES`) used for the reported trip. |\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\nBillingPlatformIdentifier\n-------------------------\n\nA set of values that indicate upon which platform the request was issued.\n\n| Enums ||\n|-------------------------------------------|----------------------------------------------------------|\n| `BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED` | Default. Used for unspecified platforms. |\n| `SERVER` | The platform is a client server. |\n| `WEB` | The platform is a web browser. |\n| `ANDROID` | The platform is an Android mobile device. |\n| `IOS` | The platform is an IOS mobile device. |\n| `OTHERS` | Other platforms that are not listed in this enumeration. |\n\nSolutionType\n------------\n\nSelector for different solution types of a reported trip.\n\n| Enums ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `SOLUTION_TYPE_UNSPECIFIED` | The default value. For backwards-compatibility, the API will use `ON_DEMAND_RIDESHARING_AND_DELIVERIES` by default which is the first supported solution type. |\n| `ON_DEMAND_RIDESHARING_AND_DELIVERIES` | The solution is an on-demand ridesharing and deliveries trip. |"]]
