Os tokens de sessão agrupam as fases de consulta e seleção de uma pesquisa de preenchimento automático do usuário em uma sessão discreta para fins de faturamento.
Criar um token de sessão
Os usuários são responsáveis por gerar tokens de sessão exclusivos para cada sessão. O Google recomenda o uso de UUIDs da versão 4.
Exemplo
À medida que o usuário digita uma consulta, uma solicitação de preenchimento automático é chamada a cada poucos toques de tecla (não por caractere) e uma lista de resultados possíveis é retornada. Quando o usuário faz uma seleção na lista de resultados, a seleção é contabilizada como uma solicitação, e todas as solicitações feitas durante a pesquisa são agrupadas e contabilizadas como uma única solicitação. Se o usuário selecionar um lugar, a consulta de pesquisa vai estar disponível sem custos financeiros, e apenas a solicitação de dados do lugar será cobrada. Se o usuário não escolher uma opção em alguns minutos após o início da sessão, apenas a consulta de pesquisa será cobrada.
Vamos examinar esse fluxo de eventos da perspectiva de um app.
- Um usuário começa a digitar uma consulta para pesquisar "Paris, França".
- Ao detectar a entrada do usuário, o app cria um novo token de sessão, "Token A".
- À medida que o usuário digita, a API faz uma solicitação de preenchimento automático a cada poucos
caracteres, mostrando uma nova lista de resultados possíveis para cada um:
"P"
"Par"
"Paris,"
"Paris, Fr"
- Quando o usuário faz uma seleção:
- Todas as solicitações resultantes da consulta são agrupadas e adicionadas à sessão representada por "Token A", como uma única solicitação.
- A seleção do usuário é contada como uma solicitação de detalhes do lugar e adicionada à sessão representada por "Token A".
- A sessão é concluída, e o app descarta o "Token A".
Para mais informações sobre como as solicitações de preenchimento automático são faturadas, consulte Uso e faturamento.