Tokeny sesji
Tokeny sesji to wygenerowane przez użytkownika ciągi znaków (lub obiekty), które śledzą wywołania autouzupełniania (nowego) jako sesje. Autouzupełnianie (nowe) używa tokenów sesji do grupowania faz zapytania i wyboru w wyszukiwaniu autouzupełniania użytkownika w osobną sesję na potrzeby rozliczeń.
Użytkownicy są odpowiedzialni za tworzenie tokenów sesji dla każdej sesji. Tokeny sesji muszą być ciągami znaków w formacie base64, które są bezpieczne dla adresów URL i nazw plików. Użytkownicy mogą generować tokeny sesji w dowolny sposób, ale Google zaleca używanie w przypadku tokenów sesji uniwersalnych identyfikatorów UUID w wersji 4.
Sesja rozpoczyna się wywołaniem funkcji Autocomplete (New) i kończy wywołaniem funkcji Place Details (New) lub Address Validation. Każda sesja może zawierać wiele zapytań Autocomplete (New), a po nich 1 żądanie dotyczące Place Details (New) lub Address Validation. Klucze interfejsu API używane w każdym żądaniu w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud.
Tokeny sesji wygasają w ten sposób:
- Nazywa się Szczegóły miejsca (Nowe).
- Wywoływana jest funkcja weryfikacji adresu.
- Sesja została przerwana.
Po zakończeniu sesji token traci ważność. Aplikacja musi wygenerować nowy token dla każdej nowej sesji. Jeśli parametr sessionToken zostanie pominięty lub jeśli ponownie użyjesz tokena sesji, za nową sesję zostanie naliczona opłata tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).
Więcej informacji o tym, jak rozliczane są żądania autouzupełniania (nowego), znajdziesz w artykule Ceny autouzupełniania (nowego) i sesji.