Токены сеанса группируют фазы запроса и выбора при автозаполнении поиска пользователя в отдельный сеанс для целей выставления счетов.
Создать токен сеанса
Пользователи несут ответственность за генерацию уникальных токенов для каждого сеанса. 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-03 UTC."],[[["\u003cp\u003eSession tokens associate autocomplete search queries and selections for billing, ensuring accurate charges based on user interactions.\u003c/p\u003e\n"],["\u003cp\u003eEach new search session requires a unique, user-generated token, ideally a version 4 UUID, to track related requests.\u003c/p\u003e\n"],["\u003cp\u003eAutocomplete requests during a search are grouped and billed as a single request when the user makes a selection, charging only for Place data if a place is chosen.\u003c/p\u003e\n"],["\u003cp\u003eIf no selection is made within a few minutes, only the search query is billed, attributing costs to the initial search activity.\u003c/p\u003e\n"],["\u003cp\u003eSession tokens are project-specific, allowing reuse across different Google Cloud projects but requiring uniqueness within the same project for proper billing.\u003c/p\u003e\n"]]],["Session tokens group user autocomplete searches for billing. Generate unique session tokens (e.g., version 4 UUIDs) per project. As users type, autocomplete requests are made. Upon selection, all requests are bundled into a single, session-token-linked request. If a place is selected, only the Place data request is charged. Otherwise, only the search query is charged. If no selection is made, the session times out, and only the search query is billed. Discard the token after the session.\n"],null,[]]
