Method: providers.billableTrips.report
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Abrechenbare Fahrten melden
HTTP-Anfrage
POST https://fleetengine.googleapis.com/v1/{name=providers/*/billableTrips/*}:report
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
name |
string
Erforderlich. Muss im Format providers/{provider}/billableTrips/{billable_trip} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project ) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
Felder |
countryCode |
string
Erforderlich. Zweistelliger Ländercode des Landes, in dem die Fahrt stattfindet. Der Preis wird gemäß dem Ländercode definiert.
|
platform |
enum (BillingPlatformIdentifier )
Die Plattform, auf der die Anfrage gestellt wurde.
|
relatedIds[] |
string
Die IDs, die sich direkt auf die gemeldete Fahrt beziehen. Das sind in der Regel IDs (z. B. Sitzungs-IDs) von Vorbuchungsvorgängen, die ausgeführt wurden, bevor die Reise-ID verfügbar war. Die Anzahl der relatedIds ist auf 50 beschränkt.
|
solutionType |
enum (SolutionType )
Die Art der GMP-Produktlösung (z. B. ON_DEMAND_RIDESHARING_AND_DELIVERIES ), die für die gemeldete Fahrt verwendet wurde.
|
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.
SolutionType
Auswahl für verschiedene Lösungstypen einer gemeldeten Fahrt.
Enums |
SOLUTION_TYPE_UNSPECIFIED |
Der Standardwert. Aus Gründen der Abwärtskompatibilität verwendet die API standardmäßig ON_DEMAND_RIDESHARING_AND_DELIVERIES , den ersten unterstützten Lösungstyp. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
Die Lösung ist eine Fahrt mit einem On-Demand-Fahrdienst und Lieferservice. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]