Na potrzeby rozliczeń tokeny sesji łączą fazy zapytania i wyboru w wyszukiwaniu autouzupełniania użytkownika w jedną sesję.
Tworzenie tokena sesji
Użytkownicy są odpowiedzialni za generowanie unikalnych tokenów sesji dla każdej sesji.
Google zaleca używanie identyfikatorów UUID w wersji 4.
Przykład
Gdy użytkownik wpisze zapytanie, co kilka znaków (a nie po każdym znaku) wywoływane jest żądanie autouzupełniania, a następnie zwracana jest lista możliwych wyników. Gdy użytkownik wybierze coś z listy wyników, wybór ten jest traktowany jako żądanie, a wszystkie żądania wysłane podczas wyszukiwania są grupowane i liczone jako jedno żądanie. Jeśli użytkownik wybierze miejsce, zapytanie jest dostępne bezpłatnie, a opłata jest pobierana tylko za żądanie danych o miejscu. Jeśli użytkownik nie dokona wyboru w ciągu kilku minut od rozpoczęcia sesji, zostanie naliczona opłata tylko za zapytanie.
Przyjrzyjmy się temu procesowi z perspektywy aplikacji.
Użytkownik zaczyna wpisywać zapytanie, aby wyszukać „Paryż, Francja”.
Po wykryciu danych wejściowych użytkownika aplikacja tworzy nowy token sesji „Token A”.
Gdy użytkownik wpisze kilka znaków, interfejs API wysyła zapytanie o autouzupełnianie po każdym znaku, wyświetlając nową listę potencjalnych wyników:
"P"
"Par"
"Paris,"
"Paris, Fr"
Gdy użytkownik dokona wyboru:
Wszystkie żądania wynikające z zapytania są grupowane i dodawane do sesji reprezentowanej przez „Token A” jako jedno żądanie.
Wybór użytkownika jest liczony jako żądanie szczegółów miejsca i dodawany do sesji reprezentowanej przez „Token A”.
Sesja została zakończona, a aplikacja odrzuciła „Token A”.
Więcej informacji o obliczaniu opłat za prośby o autouzupełnianie znajdziesz w artykule Używanie i obliczanie opłat.
[null,null,["Ostatnia aktualizacja: 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"]]
