Токены сеанса группируют фазы запроса и выбора при автозаполнении поиска пользователя в отдельный сеанс для целей выставления счетов.
Создать токен сеанса
Пользователи несут ответственность за генерацию уникальных токенов для каждого сеанса. Google рекомендует использовать UUID версии 4 .
Пример
По мере ввода пользователем запроса каждые несколько нажатий клавиш (не посимвольно) вызывается запрос автодополнения, и возвращается список возможных результатов. Когда пользователь делает выбор из списка результатов, этот выбор считается запросом, и все запросы, сделанные в ходе поиска, объединяются и учитываются как один запрос. Если пользователь выбирает место, поисковый запрос предоставляется бесплатно, а плата взимается только за запрос данных о месте. Если пользователь не делает выбор в течение нескольких минут после начала сеанса, плата взимается только за поисковый запрос.
Давайте рассмотрим этот поток событий с точки зрения приложения.
Пользователь начинает вводить поисковый запрос «Париж, Франция».
При обнаружении пользовательского ввода приложение создает новый токен сеанса — «Токен А».
По мере того, как пользователь печатает, API каждые несколько символов отправляет запрос на автодополнение, отображая для каждого из них новый список потенциальных результатов: "П" "Пар" "Париж," "Париж, Фр."
Когда пользователь делает выбор:
Все запросы, полученные в результате запроса, группируются и добавляются в сеанс, представленный «Токеном А», как один запрос.
Выбор пользователя учитывается как запрос сведений о месте и добавляется к сеансу, представленному «Токеном A».
Сеанс завершается, и приложение сбрасывает «Токен А».
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-24 UTC."],[[["Session tokens are used to group autocomplete search queries and selections for billing purposes."],["Each session requires a unique token, ideally a version 4 UUID."],["Autocomplete requests are bundled and billed as a single request when a user makes a selection."],["If no selection is made, only the search query is charged after a few minutes."],["Session tokens can be shared across different Google Cloud projects, but must be unique within a single project."]]],["This document details the use of session tokens with the Places API. A session token groups a user's autocomplete search into a single session for billing. Users must create unique session tokens (version 4 UUIDs recommended) for each session, ensuring uniqueness within a project. Requests are bundled into a session. If a user selects a place, only the place details are charged; otherwise, only the search query is charged. Each session ends after a user's selection or inactivity, at which point the token is discarded.\n"]]
