Method: providers.billableTrips.report
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Segnala l'utilizzo delle corse fatturabili.
Richiesta HTTP
POST https://fleetengine.googleapis.com/v1/{name=providers/*/billableTrips/*}:report
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
name |
string
Obbligatorio. Deve essere nel formato providers/{provider}/billableTrips/{billable_trip} . Il provider deve essere l'ID progetto (ad esempio sample-cloud-project ) del progetto Google Cloud di cui l'account di servizio che effettua questa chiamata è membro.
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Campi |
countryCode |
string
Obbligatorio. Codice paese di due lettere del paese in cui si svolge il viaggio. Il prezzo è definito in base al codice paese.
|
platform |
enum (BillingPlatformIdentifier )
La piattaforma su cui è stata emessa la richiesta.
|
relatedIds[] |
string
Gli identificatori direttamente correlati al viaggio segnalato. In genere si tratta di ID (ad esempio ID sessione) di operazioni di prenotazione effettuate prima che l'ID viaggio sia disponibile. Il numero di relatedIds è limitato a 50.
|
solutionType |
enum (SolutionType )
Il tipo di soluzione di prodotto GMP (ad es. ON_DEMAND_RIDESHARING_AND_DELIVERIES ) utilizzata per la corsa segnalata.
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta è un oggetto JSON vuoto.
SolutionType
Selettore per i diversi tipi di soluzione di un viaggio segnalato.
Enum |
SOLUTION_TYPE_UNSPECIFIED |
Il valore predefinito. Per la compatibilità con le versioni precedenti, l'API utilizzerà ON_DEMAND_RIDESHARING_AND_DELIVERIES per impostazione predefinita, che è il primo tipo di soluzione supportato. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
La soluzione è un viaggio di ridesharing e consegne on demand. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]