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 odpowiadają za tworzenie tokenów sesji dla każdej sesji. Tokeny sesji muszą być ciągami znaków w formacie base64, które są bezpieczne w adresach URL i nazwach 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ę od wywołania funkcji Autocomplete (New) i kończy się wywołaniem funkcji Place Details (New) lub Address Validation. Każda sesja może zawierać wiele zapytań Autocomplete (New), a po nich 1 prośbę o szczegóły miejsca (nowe) lub weryfikację adresu. 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:

  • wywoływana jest funkcja Place Details (New);
  • Wywoływana jest usługa Weryfikacja adresu.
  • Sesja została przerwana.

Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej nowej sesji. Jeśli parametr sessionToken zostanie pominięty lub jeśli użyjesz ponownie 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 naliczane są opłaty za żądania autouzupełniania (nowego), znajdziesz w artykule Ceny autouzupełniania (nowego) i sesji.