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 versión 4.
Ejemplo
A medida que el usuario escribe una consulta, se llama a una solicitud de autocompletado cada algunas teclas presionadas (no por carácter) y se muestra una lista de resultados posibles. Cuando el usuario realiza una selección de la lista de resultados, la selección se cuenta como 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 unos minutos después de que comienza 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 consulta para buscar "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 autocompletado cada pocos caracteres y muestra una nueva lista de resultados posibles para cada uno:
"P"
"Par"
"Paris,"
"Paris, Fr"
Cuando el usuario realiza una selección, ocurre lo siguiente:
Todas las solicitudes que resultan de la consulta 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-01-14 (UTC)"],[[["Session tokens associate autocomplete search queries and selections for billing, ensuring accurate charges based on user interactions."],["Each new search session requires a unique, user-generated token, ideally a version 4 UUID, to track related requests."],["Autocomplete 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."],["If no selection is made within a few minutes, only the search query is billed, attributing costs to the initial search activity."],["Session tokens are project-specific, allowing reuse across different Google Cloud projects but requiring uniqueness within the same project for proper billing."]]],[]]