I token di sessione raggruppano le fasi di query e selezione del completamento automatico di un utente eseguire ricerche in una sessione discreta ai fini della fatturazione.
Crea un token di sessione
Gli utenti sono responsabili della generazione di token di sessione univoci per ogni sessione. Google consiglia di utilizzare gli UUID della versione 4.
Esempio
Mentre l'utente digita una query, viene chiamata una richiesta di completamento automatico le sequenze di tasti (non per carattere) e viene restituito un elenco di possibili risultati. Quando l'utente effettua una selezione dall'elenco dei risultati, la selezione viene conteggiata come raggruppata, in cui tutte le richieste effettuate durante la ricerca vengono come una singola richiesta. Se l'utente seleziona un luogo, la query di ricerca è disponibile senza costi aggiuntivi e viene addebitata solo la richiesta di dati del luogo. Se l'utente non effettuare una selezione entro pochi minuti dall'inizio della sessione, solo della query di ricerca viene addebitato.
Esaminiamo questo flusso di eventi dal punto di vista di un'app.
- Un utente inizia a digitare una query per cercare "Parigi, Francia".
- Dopo aver rilevato l'input dell'utente, l'app crea una nuova sessione "Token A".
- Mentre l'utente digita, l'API effettua una richiesta di completamento automatico a intervalli
con un nuovo elenco di potenziali risultati per ciascuno:
"P"
"Par"
"Parigi",
"Parigi, Ven"
- Quando l'utente effettua una selezione:
- Tutte le richieste derivanti dalla query vengono raggruppate e aggiunte al sessione rappresentata da "Token A", come richiesta singola.
- La selezione dell'utente viene conteggiata come una richiesta Dettagli luogo e viene aggiunta alla sessione rappresentata da "Token A".
- La sessione si è conclusa e l'app scarta il "Token A".
Per ulteriori informazioni su come vengono fatturate le richieste di completamento automatico, consulta Utilizzo e Fatturazione.