Google Workspace userUsageReport API的date参数时区规则咨询

正确答案为选项A，具体规则拆解如下：

• 文档中提到的「建议您使用您账号的时区设置该参数」，所指的账号是发起API请求时用于鉴权的管理员账号，和userKey参数指定的被查询用户的个人时区设置没有关联。
• 接口统计逻辑：传入的date参数会自动对齐鉴权管理员账号时区下对应自然日的0点-24点时间窗口，返回该窗口内的用户使用数据。
• 另外两个选项的错误原因：
  • 选项B不成立：接口不会根据每个被查询用户的个人时区单独调整统计窗口，即便是查询全量用户（userKey=all），所有用户的数据统计也会统一对齐鉴权管理员的时区，不会出现多套统计口径。
  • 选项C不成立：接口没有统一使用UTC或其他固定时区作为统计基准，统计时区完全跟随鉴权管理员的账号时区配置变化。

实操提示：如果你需要获取UTC时区的自然日统计数据，只需要提前将发起请求的管理员账号时区修改为UTC，再传入对应UTC日期的date参数即可。

内容的提问来源于stack exchange，提问作者Hiroshi Yoshino