会话令牌

会话令牌是用户生成的字符串,可将自动补全(新)调用作为会话进行跟踪。自动补全(新)使用会话令牌将用户自动补全搜索的查询和选择阶段划分到独立的会话中,以便进行结算。

用户负责为每个会话创建会话令牌。会话令牌必须是网址和文件名安全的 base64 字符串。虽然 Google 建议为会话令牌使用版本 4 通用唯一标识符 (UUID),但用户可以以任何方式生成会话令牌。

会话首先调用自动补全(新),最后调用地点详情(新)地址验证。每个会话可以包含多个“自动补全(新)”查询,然后对“地点详情”(新)或地址验证发出一个请求。会话中的每个请求使用的 API 密钥必须属于同一个 Google Cloud 控制台项目。

会话令牌通过以下方式终止:

  • 调用“地点详情(新)”。
  • 调用地址验证。
  • 系统会放弃该会话。
会话结束后,令牌将失效;您的应用必须为每个新会话生成一个新的令牌。如果省略 sessionToken 参数,或如果您重复使用会话令牌,系统会按照未提供会话令牌的情况对新会话进行计费(每个请求均单独计费)。 如需详细了解“自动补全(新)”请求的结算方式,请参阅自动补全(新)和会话定价