Sitzungstokens fassen die Abfrage- und Auswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammen.
Sitzungstoken erstellen
Die Nutzer sind dafür verantwortlich, für jede Sitzung eindeutige Sitzungstokens zu generieren.
Google empfiehlt die Verwendung von UUIDs der Version 4.
Beispiel
Während der Nutzer eine Suchanfrage eingibt, wird alle paar Tastenanschläge (nicht pro Zeichen) eine Autocomplete-Anfrage aufgerufen und eine Liste möglicher Ergebnisse zurückgegeben. Wenn der Nutzer eine Auswahl in der Ergebnisliste trifft, wird die Auswahl als Anfrage gezählt. Alle während der Suche gestellten Anfragen werden zusammengefasst und als einzelne Anfrage gezählt. Wenn der Nutzer einen Ort auswählt, ist die Suchanfrage kostenlos und es wird nur die Anfrage für Ortsdaten berechnet. Wenn der Nutzer innerhalb weniger Minuten nach Beginn der Sitzung keine Auswahl trifft, wird nur die Suchanfrage in Rechnung gestellt.
Sehen wir uns diesen Ablauf aus der Perspektive einer App an.
Ein Nutzer beginnt, eine Suchanfrage für „Paris, Frankreich“ einzugeben.
Wenn die App Nutzereingaben erkennt, erstellt sie ein neues Sitzungstoken, „Token A“.
Während der Nutzer tippt, sendet die API alle paar Zeichen eine Anfrage für die automatische Vervollständigung und zeigt für jede Anfrage eine neue Liste mit möglichen Ergebnissen an:
„P“
„Par“
„Paris,“
„Paris, Fr“
Wenn der Nutzer eine Auswahl trifft:
Alle Anfragen, die aus der Abfrage resultieren, werden gruppiert und der Sitzung, die durch „Token A“ dargestellt wird, als einzelne Anfrage hinzugefügt.
Die Auswahl des Nutzers wird als „Place Details“-Anfrage gezählt und der Sitzung mit dem Token „A“ hinzugefügt.
Die Sitzung ist beendet und die App verwirft „Token A“.
Weitere Informationen zur Abrechnung von Autocomplete-Anfragen finden Sie unter Nutzung und Abrechnung.
[null,null,["Zuletzt aktualisiert: 2025-02-28 (UTC)."],[[["Session tokens associate autocomplete search queries and selections for billing, ensuring accurate charges based on user interactions."],["Each new search session requires a unique, user-generated token, ideally a version 4 UUID, to track related requests."],["Autocomplete requests during a search are grouped and billed as a single request when the user makes a selection, charging only for Place data if a place is chosen."],["If no selection is made within a few minutes, only the search query is billed, attributing costs to the initial search activity."],["Session tokens are project-specific, allowing reuse across different Google Cloud projects but requiring uniqueness within the same project for proper billing."]]],["Session tokens group user autocomplete searches for billing. Generate unique session tokens (e.g., version 4 UUIDs) per project. As users type, autocomplete requests are made. Upon selection, all requests are bundled into a single, session-token-linked request. If a place is selected, only the Place data request is charged. Otherwise, only the search query is charged. If no selection is made, the session times out, and only the search query is billed. Discard the token after the session.\n"]]