Method: providers.billableTrips.report
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
گزارش استفاده از سفر قابل پرداخت
درخواست HTTP
POST https://fleetengine.googleapis.com/v1/{name=providers/*/billableTrips/*}:report
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
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 خالی است.
نوع راه حل
انتخابگر برای انواع راه حل های مختلف یک سفر گزارش شده.
Enums |
---|
SOLUTION_TYPE_UNSPECIFIED | مقدار پیش فرض برای سازگاری با عقب، API به طور پیش فرض ON_DEMAND_RIDESHARING_AND_DELIVERIES استفاده می کند که اولین نوع راه حل پشتیبانی شده است. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES | راه حل این است که بر حسب تقاضا سفری به اشتراک گذاشته شود. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]