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