调用CalendarList.list接口时为何抛出notACalendarUser错误？

当调用CalendarList.list接口返回notACalendarUser错误，但确认用户是有效Google Calendar用户时，可从以下几个方向排查：

• 确认授权权限范围
  确保OAuth 2.0授权令牌包含Calendar相关权限，至少需要https://www.googleapis.com/auth/calendar.readonly（只读访问）或https://www.googleapis.com/auth/calendar（读写访问）。如果首次授权未请求这些范围，需引导用户重新完成授权流程，获取包含正确权限的令牌。

• 检查用户的Calendar服务启用状态
  若用户属于Google Workspace域，联系域管理员确认该用户的Google Calendar服务是否被禁用。管理员可在Admin Console的「应用 > Google Workspace > 日历」中查看并调整用户的服务启用状态。

• 验证请求中的userId参数
  调用接口时，若指定了userId，确保其值为用户的主邮箱地址或'primary'（指代当前授权用户）。使用服务账号进行域范围委派时，需确认userId对应的是域内已启用Calendar的有效用户邮箱，避免拼写错误。

• 排查服务账号配置（若使用）
  若通过服务账号调用API：

  • 确认服务账号已在Google Cloud Console中启用Google Calendar API
  • 已为服务账号配置域范围委派，并添加了Calendar相关的权限范围
  • 调用时正确模拟目标用户（userId参数无误）

• 刷新授权令牌
  尝试重新获取访问令牌，避免因令牌过期或权限缺失导致的错误。对于用户授权场景，引导用户重新登录授权，确保授权流程中明确请求了Calendar权限。

内容的提问来源于stack exchange，提问作者chris.mclennon