Method: providers.billableTrips.report
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Báo cáo mức sử dụng chuyến đi có thể tính phí.
Yêu cầu HTTP
POST https://fleetengine.googleapis.com/v1/{name=providers/*/billableTrips/*}:report
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
name |
string
Bắt buộc. Phải ở định dạng providers/{provider}/billableTrips/{billable_trip} . Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project ) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Trường |
countryCode |
string
Bắt buộc. Mã quốc gia gồm hai chữ cái của quốc gia nơi diễn ra chuyến đi. Giá được xác định theo mã quốc gia.
|
platform |
enum (BillingPlatformIdentifier )
Nền tảng phát hành yêu cầu.
|
relatedIds[] |
string
Giá trị nhận dạng liên quan trực tiếp đến chuyến đi đang được báo cáo. Đây thường là mã nhận dạng (ví dụ: mã phiên) của các thao tác đặt trước được thực hiện trước khi có mã chuyến đi. Số lượng relatedIds bị giới hạn ở mức 50.
|
solutionType |
enum (SolutionType )
Loại giải pháp sản phẩm GMP (ví dụ: ON_DEMAND_RIDESHARING_AND_DELIVERIES ) được dùng cho chuyến đi được báo cáo.
|
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ là một đối tượng JSON trống.
SolutionType
Bộ chọn cho các loại giải pháp khác nhau của một chuyến đi đã báo cáo.
Enum |
SOLUTION_TYPE_UNSPECIFIED |
Giá trị mặc định. Để tương thích ngược, theo mặc định, API sẽ sử dụng ON_DEMAND_RIDESHARING_AND_DELIVERIES , đây là loại giải pháp được hỗ trợ đầu tiên. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
Giải pháp này là một chuyến đi chia sẻ xe và giao hàng theo yêu cầu. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]