Używanie tokenów sesji

Wybierz platformę: Android iOS Usługa internetowa

Tokeny sesji grupują fazy zapytania i wyboru użytkownika autouzupełniania w dyskretnej sesji 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 razy. naciśnięć klawiszy (nie poszczególnych znaków) i zwracana jest lista możliwych wyników. Kiedy użytkownik dokona wyboru z listy wyników, wybór liczy się jako i wszystkie żądania wysyłane podczas wyszukiwania są grupowane i zliczane jako pojedynczą prośbę. Jeśli użytkownik wybierze miejsce, dostępne jest zapytanie bezpłatnie, a opłata zostanie naliczona tylko za żądanie danych dotyczących miejsca. Jeśli użytkownik nie wyrazi zgody, w ciągu kilku minut przed rozpoczęciem sesji, tylko naliczana jest opłata za wyszukiwane hasło.

Przyjrzyjmy się temu procesowi zdarzeń z perspektywy aplikacji.

  1. Użytkownik zaczyna wpisywać zapytanie, aby wyszukać „Paryż, Francja”.
  2. Po wykryciu danych wejściowych użytkownika aplikacja tworzy nową sesję „Token A”.
  3. Gdy użytkownik wpisuje tekst, interfejs API wysyła żądanie autouzupełniania co kilka znaków, wyświetlająca nową listę potencjalnych wyników dla każdego z tych elementów:
    „O”
    „Par”
    „Paryż”,
    „Paryż, pt”
  4. Gdy użytkownik dokona wyboru:
    • Wszystkie żądania wynikające z zapytania są grupowane i dodawane do sekcji reprezentowana przez „Token A” jako pojedyncze żądanie.
    • Wybór użytkownika jest liczony jako żądanie szczegółowych informacji o miejscu i dodany, sesji reprezentowanej przez „Token A”.
  5. Sesja dobiega końca, a aplikacja odrzuca „Token A”.

Więcej informacji o opłatach za żądania autouzupełniania znajdziesz w sekcji Korzystanie i Płatności.