Использовать токены сеанса

Выберите платформу: Android iOS Веб-сервис

Токены сессии объединяют этапы запроса и выбора в поиске с автозаполнением в отдельную сессию для целей выставления счетов.

Создайте токен сессии

Пользователи несут ответственность за генерацию уникальных токенов сессии для каждой сессии. Google рекомендует использовать UUID версии 4 .

Пример

По мере ввода пользователем запроса, запрос автозаполнения вызывается каждые несколько нажатий клавиш (не для каждого символа), и возвращается список возможных результатов. Когда пользователь выбирает что-либо из списка результатов, выбор считается запросом, и все запросы, сделанные во время поиска, объединяются и учитываются как один запрос. Если пользователь выбирает место, поисковый запрос доступен бесплатно, и оплачивается только запрос данных о месте. Если пользователь не делает выбор в течение нескольких минут с начала сессии, оплачивается только поисковый запрос.

Давайте рассмотрим эту последовательность событий с точки зрения приложения.

  1. Пользователь начинает вводить поисковый запрос, чтобы найти "Париж, Франция".
  2. После получения ввода от пользователя приложение создает новый токен сессии, "Токен А".
  3. По мере ввода пользователем текста API отправляет запрос автозаполнения каждые несколько символов, отображая для каждого из них новый список возможных результатов:
    "П"
    "Пар"
    "Париж,"
    "Париж, Франция"
  4. Когда пользователь делает выбор:
  • Все запросы, возникающие в результате выполнения запроса, группируются и добавляются к сессии, представленной "Токеном А", как единый запрос.
  • Выбор пользователя учитывается как запрос сведений о месте и добавляется в сессию, представленную "токеном A".
  • Сессия завершена, и приложение удаляет «Токен А».

Для получения более подробной информации о порядке оплаты запросов автозаполнения см. раздел «Использование и оплата» .