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

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

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

Создать токен сеанса

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

Пример

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

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

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

Дополнительные сведения о том, как оплачиваются запросы автозаполнения, см. в разделе Использование и выставление счетов .