Los tokens de sesión agrupan las etapas de consulta y selección de la búsqueda con autocompletado de un usuario en una sesión discreta para realizar la facturación correspondiente.
Crea un token de sesión
Los usuarios son responsables de generar tokens de sesión únicos para cada sesión. Google recomienda usar UUIDs de la versión 4.
Ejemplo
A medida que el usuario escribe una búsqueda, se llama a una solicitud de autocompletado cada pocos toques de teclas (no por carácter) y se devuelve una lista de posibles resultados. Cuando el usuario realiza una selección en la lista de resultados, la selección se considera una solicitud, y todas las solicitudes realizadas durante la búsqueda se agrupan y se cuentan como una sola solicitud. Si el usuario selecciona un lugar, la búsqueda está disponible sin cargo, y solo se cobra la solicitud de datos de Place. Si el usuario no realiza una selección en los primeros minutos de la sesión, solo se cobra la búsqueda.
Examinemos este flujo de eventos desde la perspectiva de una app.
Un usuario comienza a escribir una búsqueda para encontrar “París, Francia”.
Cuando detecta la entrada del usuario, la app crea un nuevo token de sesión, "Token A".
A medida que el usuario escribe, la API realiza una solicitud de autocompletar cada pocos caracteres y muestra una nueva lista de posibles resultados para cada uno:
"P"
"Par"
"París"
"París, Francia"
Cuando el usuario realiza una selección, sucede lo siguiente:
Todas las solicitudes que resultan de la búsqueda se agrupan y se agregan a la sesión representada por "Token A", como una sola solicitud.
La selección del usuario se cuenta como una solicitud de Place Details y se agrega a la sesión representada por "Token A".
La sesión finaliza y la app descarta el "Token A".
Para obtener más información sobre cómo se facturan las solicitudes de Autocomplete, consulta Uso y facturación.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-10 (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,[]]