会话令牌对用户自动补全的查询和选择阶段进行分组 出于结算目的搜索单独的会话。
创建会话令牌
用户负责为每个会话生成唯一的会话令牌。 Google 建议使用版本 4 UUID。
示例
当用户输入查询时,系统会每隔几个调用一次“自动补全”请求 (而非每个字符),系统会返回一系列可能的结果。时间 当用户从结果列表中进行选择时,该选择将计为 且搜索期间发出的所有请求都会汇总到 处理为一个请求如果用户选择某个地点,则提供搜索查询 且仅对地点数据请求收费。如果用户没有 在会话开始的几分钟内做出选择, 搜索查询费用。
让我们从应用的角度来研究这种事件流。
- 用户开始输入查询内容来搜索“Paris, France”。
- 在检测到用户输入后,应用会创建一个新会话 令牌“令牌 A”。
- 在用户输入时,API 每隔几个会发出一个“自动补全”请求
字符,显示每个字符的新潜在结果列表:
“P”
“标准杆”
“Paris”
“Paris, Fr”
- 当用户做出选择时:
- 由查询生成的所有请求都会分组并添加到 以单个请求的形式表示,该会话由“令牌 A”表示。
- 用户的选择会被计为“地点详情”请求,并会将其添加到 访问以“令牌 A”表示的会话。
- 会话结束,应用舍弃“令牌 A”。
有关“自动补全”请求如何计费的更多信息,请参见使用量和 结算。