Google Calendar API获取日历列表为何需敏感权限？能否调整？

核心原因 #

你遇到的403错误主要由以下几种情况导致：

• 权限范围格式错误：你可能使用了简写的calendarlist.readonly，但Google OAuth要求权限范围必须是完整的URI格式：https://www.googleapis.com/auth/calendar.calendarlist.readonly。简写形式无法被API正确识别，触发权限验证失败。
• OAuth令牌未包含目标权限：如果之前用calendar.readonly授权过，旧访问令牌不会自动新增calendar.calendarlist.readonly权限。必须重新引导用户完成授权流程，获取包含新权限的令牌。
• Cloud Console权限配置遗漏：在Google Cloud Console的OAuth同意屏幕中，你可能未添加calendar.calendarlist.readonly权限范围。即便代码里指定了该权限，控制台未配置的话，授权流程不会向用户请求该权限，最终令牌自然没有对应权限。

调整方案 #

按以下步骤排查修复：

1. 使用完整权限URI：确保OAuth授权请求中指定的权限是完整的https://www.googleapis.com/auth/calendar.calendarlist.readonly，而非简写形式。
2. 重新获取授权令牌：废弃旧令牌，引导用户重新完成授权流程，确保新令牌包含calendar.calendarlist.readonly权限。可通过Google的令牌信息验证工具检查令牌包含的权限范围，确认是否生效。
3. 配置Cloud Console权限：登录Google Cloud Console，找到你的应用，进入「OAuth同意屏幕」页面，在「已授权的范围」中添加https://www.googleapis.com/auth/calendar.calendarlist.readonly，保存后重新测试。
4. 验证请求有效性：确认请求目标是calendarList端点（https://www.googleapis.com/calendar/v3/users/me/calendarList），同时检查请求头中的令牌是否正确、是否在有效期内。

补充说明 #

官方文档明确calendar.calendarlist.readonly是访问日历列表的最小权限，只要严格遵循Google OAuth的权限规范（完整URI、正确配置控制台、重新授权），就可以用这个低权限替代calendar.readonly，避免申请敏感权限的流程。

内容的提问来源于stack exchange，提问作者Nicolas Martinez