会话令牌
会话令牌是用户生成的字符串(或对象),用于将自动补全(新)调用作为会话进行跟踪。自动补全(新)使用会话令牌将用户自动补全搜索的查询和选择阶段分组为一个单独的会话,以便进行结算。
用户负责为每个会话创建会话令牌。会话令牌必须是可在网址和文件名中安全使用的 base64 字符串。用户可以通过任何方式生成会话令牌,但 Google 建议为会话令牌使用版本 4 的通用唯一标识符 (UUID)。
会话以对“自动补全(新)”的调用开始,并以对地点详情(新)或地址验证的调用结束。在每个会话中,用户可以输入多项“自动补全(新)”查询,并最终发出一个“地点详情(新)”或“地址验证”请求。在一个会话中,用于每个请求的 API 密钥必须属于同一 Google Cloud 控制台项目。
会话令牌会以以下方式终止:
- 调用地点详情(新)。
- 调用地址验证。
- 会话被放弃。
会话结束后,令牌将失效;您的应用必须为每个新会话生成一个新的令牌。如果您省略 sessionToken 参数或重复使用会话令牌,系统会按未提供会话令牌的情况为新会话计费(每个请求均单独结算)。
如需详细了解“自动补全(新)”请求的结算方式,请参阅“自动补全(新)”和会话价格。