Utiliser des jetons de session

Les jetons de session regroupent les phases de requête et de sélection d'une recherche avec saisie semi-automatique d'un utilisateur dans une session distincte à des fins de facturation.

Créer un jeton de session

Les utilisateurs sont chargés de générer des jetons de session uniques pour chaque session. Google recommande d'utiliser les UUID version 4.

Remarque :Les jetons de session peuvent se chevaucher entre les projets de la console Google Cloud, mais ils doivent être uniques pour chaque projet. Par exemple, une application utilisant le projet A et une application utilisant le projet B peuvent utiliser le même jeton de session, mais plusieurs applications utilisant le projet A ne peuvent pas utiliser le même jeton de session.

Exemple

Lorsque l'utilisateur saisit une requête, une requête de saisie semi-automatique est appelée au bout de quelques frappes (et non par caractère), et une liste des résultats possibles est renvoyée. Lorsque l'utilisateur effectue une sélection dans la liste des résultats, celle-ci est comptabilisée comme une requête. Toutes les requêtes effectuées lors de la recherche sont regroupées et comptabilisées comme une seule requête. Si l'utilisateur sélectionne un lieu, la requête de recherche est disponible sans frais, et seule la requête de données de lieu est facturée. Si l'utilisateur ne fait pas de sélection dans les quelques minutes qui suivent le début de la session, seule la requête de recherche est facturée.

Examinons ce flux d'événements du point de vue d'une application.

1. Un utilisateur commence à saisir une requête pour rechercher "Paris, France".
2. Lors de la détection d'une entrée utilisateur, l'application crée un jeton de session, "Jeton A".
3. À mesure que l'utilisateur saisit du texte, l'API envoie une requête de saisie semi-automatique à un intervalle de quelques caractères, affichant une nouvelle liste de résultats potentiels pour chacun d'eux:
   "P"
   "Par"
   "Paris",
   "Paris, Fr"
   
4. Lorsque l'utilisateur effectue une sélection:
• Toutes les requêtes résultant de la requête sont regroupées et ajoutées à la session représentée par "Jeton A", sous la forme d'une requête unique.
• La sélection de l'utilisateur est comptabilisée comme une requête Place Details et ajoutée à la session représentée par le "Jeton A".
5. La session est terminée, et l'application supprime le "jeton A".

Pour en savoir plus sur la facturation des requêtes Autocomplete, consultez la section Utilisation et facturation.