本文档包含 Google Classroom 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 Cloud 项目的附件，以在您在 Google 课堂中教授的课程中流式传输内容。 |
https://www.googleapis.com/auth/classroom.addons.student
|
查看和更新请求的 Google Cloud 项目的附件，以在 Google 课堂中流式传输内容。 |
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 课堂中查看主题。 |