选择 GoogleClassroom API 范围

本文档包含 Google 课堂 API 专属的授权和身份验证信息。在阅读本文档之前，请务必先阅读 了解身份验证和授权，了解 Google Workspace 的一般身份验证和授权信息。

配置 OAuth 2.0 以进行授权

配置 OAuth 权限请求页面并选择范围，以定义向用户和应用审核者显示哪些信息，并注册应用以便以后发布。

Classroom API 范围

如需定义授予应用的访问权限级别，您需要确定并声明授权范围。授权范围是一个 OAuth 2.0 URI 字符串，其中包含 Google Workspace 应用名称、应用访问的数据类型以及访问权限级别。范围是您的应用对使用 Google Workspace 数据（包括用户的 Google 账号数据）的请求。

当应用安装完毕后，系统会要求用户验证应用使用的范围。一般来说，您应尽可能选择范围最窄的权限，并避免请求应用不需要的权限。用户更乐意向描述清晰的有限范围授予访问权限。

如果您的公开应用使用的范围允许访问某些用户数据，则必须完成验证流程。如果您在测试应用时发现屏幕上显示未经验证的应用，则必须通过提交验证请求移除该消息。请详细了解未经验证的应用，并在帮助中心获取 有关应用验证的常见问题解答。

Classroom API 支持以下范围：

范围	含义
https://www.googleapis.com/auth/classroom.addons.teacher	针对您在 Google 课堂中教授的课程，查看、创建和更新请求 Google Cloud 项目的附件，以将附件添加到信息流项目。
https://www.googleapis.com/auth/classroom.addons.student	在 Google 课堂中查看和更新请求 Google Cloud 项目的附件，以用于流项目。
https://www.googleapis.com/auth/classroom.announcements	在 Google 课堂中查看和管理通告。
https://www.googleapis.com/auth/classroom.announcements.readonly	在 Google 课堂中查看通告。
https://www.googleapis.com/auth/classroom.courses	查看、修改、创建及永久删除您的 Google 课堂课程。
https://www.googleapis.com/auth/classroom.courses.readonly	查看您的 Google 课堂课程。
https://www.googleapis.com/auth/classroom.coursework.me	查看、创建和修改课程项目，包括作业、题目和成绩。
https://www.googleapis.com/auth/classroom.coursework.me.readonly	在 Google 课堂中查看您的课程作业和成绩。
https://www.googleapis.com/auth/classroom.coursework.students	管理您在 Google 课堂中教授的课程的学生作业和成绩，并查看您管理的课程的学生作业和成绩。
https://www.googleapis.com/auth/classroom.coursework.students.readonly	查看您在 Google 课堂中教授或管理的课程的学生作业和成绩。
https://www.googleapis.com/auth/classroom.courseworkmaterials	在 Google 课堂中查看、修改和创建课业资料。
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly	查看您的 Google 课堂课程的所有课业资料。
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly	查看您在 Google 课堂中的课程所面向的学生的监护人。
https://www.googleapis.com/auth/classroom.guardianlinks.students	查看和管理您在 Google 课堂中的课程所面向的学生的监护人。
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly	查看您在 Google 课堂中的课程所面向的学生的监护人。
https://www.googleapis.com/auth/classroom.profile.emails	查看您课程中用户的电子邮件地址。
https://www.googleapis.com/auth/classroom.profile.photos	查看您课程中用户的个人资料照片。
https://www.googleapis.com/auth/classroom.push-notifications	接收有关您的 Google 课堂数据的通知。
https://www.googleapis.com/auth/classroom.rosters	管理 Google 课堂课程的参与者名单。
https://www.googleapis.com/auth/classroom.rosters.readonly	查看您 Google 课堂课程的参与者名单。
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly	在 Google 课堂中查看您的课程作业和成绩。
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly	查看您在 Google 课堂中教授或管理的课程的学生作业和成绩。
https://www.googleapis.com/auth/classroom.topics	在 Google 课堂中查看、创建和修改主题。
https://www.googleapis.com/auth/classroom.topics.readonly	在 Google 课堂中查看主题。