使用会话令牌

会话令牌将用户自动补全搜索的查询和选择阶段归入不同的会话，以便进行结算。

创建会话令牌

用户负责为每个会话生成唯一的会话令牌。Google 建议使用版本 4 UUID。

示例

当用户输入查询时，系统会每隔几次按键（而不是每个字符）调用一次自动补全请求，并返回可能的结果列表。当用户从结果列表中进行选择时，该选择会计为一次请求，并且搜索期间发出的所有请求都会捆绑在一起，并计为一次请求。如果用户选择了某个地点，则搜索查询免费，仅地点数据请求会产生费用。如果用户在会话开始后的几分钟内未做出选择，则系统只会对搜索查询收费。

我们从应用的角度来了解一下这一事件流程。

1. 用户开始输入查询内容，搜索“法国巴黎”。
2. 检测到用户输入后，应用会创建一个新的会话令牌“令牌 A”。
3. 当用户输入时，API 会在用户每输入几个字符后发出一次自动补全请求，并为每个请求显示一个新的可能结果列表：
   “P”
   “Par”
   “Paris,”
   “Paris, Fr”
4. 当用户做出选择时：

• 由该查询产生的所有请求都会分组并添加到由“令牌 A”表示的会话中，作为单个请求。
• 用户的选择会计为一次“地点详情”请求，并添加到由“令牌 A”表示的会话中。
• 会话结束，应用会舍弃“令牌 A”。

如需详细了解自动补全请求的结算方式，请参阅用量和结算。