Токены сеанса группируют этапы запроса и выбора пользовательского поиска с автозаполнением в отдельный сеанс для целей выставления счетов.
Создать токен сеанса
Пользователи несут ответственность за создание уникальных токенов сеанса для каждого сеанса. Google рекомендует использовать UUID версии 4 .
Пример
Когда пользователь вводит запрос, запрос автозаполнения вызывается каждые несколько нажатий клавиш (не для каждого символа), и возвращается список возможных результатов. Когда пользователь делает выбор из списка результатов, этот выбор считается запросом, а все запросы, сделанные во время поиска, объединяются и учитываются как один запрос. Если пользователь выбирает место, поисковый запрос доступен бесплатно, и взимается только плата за запрос данных о месте. Если пользователь не делает выбор в течение нескольких минут после начала сеанса, тарифицируется только поисковый запрос.
Давайте рассмотрим этот поток событий с точки зрения приложения.
- Пользователь начинает вводить запрос для поиска «Париж, Франция».
- Обнаружив ввод пользователя, приложение создает новый токен сеанса «Токен A».
- По мере ввода пользователем API выполняет запрос автозаполнения каждые несколько символов, отображая новый список потенциальных результатов для каждого:
"П"
"Пар"
"Париж,"
«Париж, фр.» - Когда пользователь делает выбор:
- Все запросы, возникающие в результате запроса, группируются и добавляются к сеансу, представленному «Токеном A», как один запрос.
- Выбор пользователя считается запросом сведений о месте и добавляется к сеансу, представленному «токеном A».
- Сеанс завершается, и приложение удаляет «токен А».
Дополнительные сведения о том, как оплачиваются запросы автозаполнения, см. в разделе Использование и выставление счетов .