Używanie tokenów sesji

Tokeny sesji łączą fazy zapytania i wyboru w wyszukiwaniu autouzupełniania użytkownika w jedną 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 wpisze zapytanie, po każdym naciśnięciu klawisza (a nie po każdym znaku) wywoływane jest żądanie autouzupełniania i 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 obciążony tylko za zapytanie.

Przyjrzyjmy się temu procesowi z perspektywy aplikacji.

1. Użytkownik zaczyna wpisywać zapytanie, aby wyszukać „Paryż, Francja”.
2. Po wykryciu danych wejściowych użytkownika aplikacja tworzy nowy token sesji „Token A”.
3. Gdy użytkownik wpisze kilka znaków, interfejs API wysyła żądanie autouzupełniania co kilka znaków, wyświetlając nową listę potencjalnych wyników:
   "P"
   "Par"
   "Paris,"
   "Paris, Fr"
   
4. Gdy użytkownik dokona wyboru:
• Wszystkie żądania wynikające z zapytania są grupowane i dodawane do sesji reprezentowanej przez „Token A” jako pojedyncze żądanie.
• Wybór użytkownika jest liczony jako żądanie szczegółów miejsca i dodawany do sesji reprezentowanej przez „Token A”.
5. 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.