Tokeny sesji grupują fazy zapytania i wyboru autouzupełniania wyszukiwania użytkownika w oddzielną sesję na potrzeby rozliczeń.
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 wpisuje zapytanie, żądanie autouzupełniania jest wywoływane co kilka naciśnięć klawiszy (a nie po poszczególnych znakach) i zwraca listę możliwych wyników. Gdy użytkownik wybierze coś z listy wyników, wybór jest liczony jako żądanie, a wszystkie żądania wysyłane podczas wyszukiwania są grupowane i zliczane jako jedno żądanie. Jeśli użytkownik wybierze miejsce, zapytanie jest dostępne bezpłatnie, a płatne są tylko żądania dotyczące danych o miejscu. Jeśli użytkownik nie dokona wyboru w ciągu kilku minut przed rozpoczęciem sesji, opłata zostanie naliczona tylko za zapytanie.
Przyjrzyjmy się temu procesowi zdarzeń 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 wpisuje tekst, interfejs API wysyła żądanie autouzupełniania co kilka znaków, wyświetlając nową listę potencjalnych wyników dla każdego z nich:
„P”
„Par”
„Paryż”,
„Paryż, pt”
- Gdy użytkownik dokona wyboru:
- Wszystkie żądania pochodzące z zapytania są grupowane i dodawane do sesji reprezentowanej przez „Token A” jako pojedyncze żądanie.
- Wybór użytkownika jest zliczany jako żądanie informacji o miejscu i dodawany do sesji reprezentowanej przez „Token A”.
- Sesja dobiega końca, a aplikacja odrzuca „Token A”.
Więcej informacji o opłatach za żądania autouzupełniania znajdziesz w artykule Użycie i rozliczenia.