调用Google Classroom API获取课程公告时遇ACCESS_TOKEN_SCOPE_INSUFFICIENT错误

核心原因 #

你遇到的问题并非课程角色限制（网页能查看公告说明账号具备对应权限），而是获取访问令牌时未请求公告相关的权限范围。尽管你在OAuth同意屏幕配置了所有测试范围，但实际生成令牌时必须明确指定所需范围，否则令牌不会自动包含这些权限：

• 调用courses.get仅需classroom.courses.readonly范围，这也是你能成功获取课程详情的原因；
• 调用courses.announcements.list需要额外的classroom.announcements.readonly（只读）或classroom.announcements（读写）范围。

具体解决步骤 #

1. 检查OAuth授权请求的范围参数
   确保发起OAuth授权请求时，scope参数包含公告相关权限。例如：

   scope=https://www.googleapis.com/auth/classroom.courses.readonly https://www.googleapis.com/auth/classroom.announcements.readonly
   

   若使用客户端库，需确认初始化客户端时传入了正确的范围数组，以Python客户端库为例：

   SCOPES = [
       'https://www.googleapis.com/auth/classroom.courses.readonly',
       'https://www.googleapis.com/auth/classroom.announcements.readonly'
   ]
   

2. 重新获取访问令牌
   旧令牌的权限范围不包含公告权限，需执行以下操作：

   • 清除之前的OAuth授权缓存（比如浏览器中对应应用的授权会话，或客户端存储的旧令牌）；
   • 重新走OAuth授权流程，确保用户授权时能看到包含公告权限的授权提示。

3. 验证令牌的实际范围
   可通过以下接口检查当前令牌的权限范围：

   GET https://www.googleapis.com/oauth2/v3/tokeninfo?access_token=YOUR_ACCESS_TOKEN
   

   响应中的scope字段会列出令牌包含的所有权限，确认是否存在classroom.announcements.readonly或classroom.announcements。

4. 确认OAuth同意屏幕的范围配置
   再次检查OAuth同意屏幕中是否确实添加了classroom.announcements.readonly或classroom.announcements范围，确保配置已保存并生效。

内容的提问来源于stack exchange，提问作者David Lee