Токены сеанса группируют фазы запроса и выбора при автозаполнении поиска пользователя в отдельный сеанс для целей выставления счетов.
Создать токен сеанса
Пользователи несут ответственность за генерацию уникальных токенов для каждого сеанса. 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-09-12 UTC."],[[["\u003cp\u003eSession tokens are used to group autocomplete search queries and selections for billing purposes.\u003c/p\u003e\n"],["\u003cp\u003eEach session requires a unique token, ideally a version 4 UUID.\u003c/p\u003e\n"],["\u003cp\u003eAutocomplete requests are bundled and billed as a single request when a user makes a selection.\u003c/p\u003e\n"],["\u003cp\u003eIf no selection is made, only the search query is charged after a few minutes.\u003c/p\u003e\n"],["\u003cp\u003eSession tokens can be shared across different Google Cloud projects, but must be unique within a single project.\u003c/p\u003e\n"]]],["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"],null,[]]
