Les jetons de session regroupent les phases de requête et de sélection d'une recherche de 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 de la version 4.
Exemple
Lorsque l'utilisateur saisit une requête, une requête de saisie semi-automatique est appelée toutes les quelques frappes (et non par caractère), et une liste de résultats possibles est renvoyée. Lorsque l'utilisateur fait une sélection dans la liste de résultats, la sélection est comptabilisée comme une requête, et 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 sur le lieu est facturée. Si l'utilisateur ne fait pas de sélection dans les quelques minutes suivant 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.
Un utilisateur commence à saisir une requête pour rechercher "Paris, France".
Lorsque l'application détecte une entrée utilisateur, elle crée un nouveau jeton de session, "Jeton A".
À mesure que l'utilisateur saisit du texte, l'API envoie une requête de saisie semi-automatique tous les quelques caractères, et affiche une nouvelle liste de résultats potentiels pour chacun:
"P"
"Par"
"Paris,"
"Paris, Fr"
Lorsque l'utilisateur fait une sélection:
Toutes les requêtes issues de la requête sont regroupées et ajoutées à la session représentée par "Jeton A", en tant que 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 "Jeton A".
La session est terminée, et l'application supprime le jeton A.
Pour en savoir plus sur la facturation des requêtes de saisie semi-automatique, consultez Utilisation et facturation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/01/14 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/01/14 (UTC)."],[[["Session tokens are used to group autocomplete search queries and selections for billing purposes."],["Each session requires a unique token, ideally a version 4 UUID."],["Autocomplete requests are bundled and billed as a single request when a user makes a selection."],["If no selection is made, only the search query is charged after a few minutes."],["Session tokens can be shared across different Google Cloud projects, but must be unique within a single project."]]],[]]
