会话令牌将用户自动补全搜索的查询和选择阶段归入不同的会话,以便进行结算。
创建会话令牌
用户负责为每个会话生成唯一的会话令牌。 Google 建议使用版本 4 UUID。
示例
当用户输入查询时,系统会每隔几次按键(而非按字符)调用一次自动补全请求,并返回可能的结果列表。当用户从结果列表中进行选择时,该选择会计为一次请求,并且搜索期间发出的所有请求都会捆绑在一起,计为一次请求。如果用户选择某个地点,则搜索查询是免费的,只有地点数据请求需要付费。如果用户在会话开始后的几分钟内未做出选择,系统只会针对搜索查询收费。
我们从应用的角度来审视这一事件流程。
- 用户开始输入查询,搜索“法国巴黎”。
- 检测到用户输入后,应用会创建一个新的会话令牌“令牌 A”。
- 用户输入字符时,API 会每输入几个字符就发出一次自动补全请求,并针对每个字符显示一个新的可能结果列表:
“P”
“Par”
“Paris,”
“Paris, Fr”
- 当用户进行选择时:
- 查询产生的所有请求会被分组,并作为单个请求添加到由“令牌 A”表示的会话中。
- 系统会将用户的选择计为一次地点详情请求,并将其添加到由“令牌 A”表示的会话中。
- 会话结束,应用舍弃“令牌 A”。
如需详细了解自动补全请求的结算方式,请参阅使用量和结算。