Google 课堂界面支持五种类型的课业：作业、测验作业、简答题、选择题和资料。Classroom API 目前支持以下三种类型（在 API 中称为 CourseWorkType）：作业、简答题和单选题。
如需访问此功能，您可以使用 CourseWork 资源，该资源表示特定课程中布置给学生的作业或题目，包括任何其他资料和详细信息（例如截止日期或最高得分）。
除了 CourseWork 资源之外，您还可以使用 StudentSubmission 资源管理已完成的作业。以下部分将对其进行更加详细的介绍。
创建作业
您只能代表课程的教师创建作业，如果您尝试代表学生在课程中创建作业，会导致 403 PERMISSION_DENIED 错误。同样，网域管理员也无法为不教授的课程创建分配，如果尝试通过 API 创建分配，则会导致 403 PERMISSION_DENIED 错误。
使用 courses.courseWork.create 方法创建分配时，您可以以 materials 的形式附加链接，如以下示例代码所示：
Java
Python
结果将包含由服务器分配的标识符，此标识符可用于在其他 API 请求中引用分配。
如需在通过 Classroom API 创建的作业中添加链接的资料，请使用链接资源，并指定目标网址。Google 课堂会自动提取标题和缩略图。 Classroom API 还原生支持 Google 云端硬盘和 YouTube 资料，可以通过类似方式将它们添加到 DriveFile 资源或 YouTubeVideo 资源中。
如需指定截止日期，请将 dueDate 和 dueTime 字段设置为相应的世界协调时间 (UTC)。截止日期必须是将来的日期。
检索作业和题目
您可以检索相应课程的学生和教师或通过网域管理员检索的作业和题目。要检索特定作业或题目，请使用 course.courseWork.get。要检索所有作业或题目（可以选择匹配某些条件），请使用 courses.courseWork.list。
所需范围取决于发出请求的用户在课程中拥有的角色。如果用户是学生，请使用以下范围之一：
https://www.googleapis.com/auth/classroom.coursework.me.readonlyhttps://www.googleapis.com/auth/classroom.coursework.me
如果用户是教师或网域管理员，请使用以下范围之一：
https://www.googleapis.com/auth/classroom.coursework.students.readonlyhttps://www.googleapis.com/auth/classroom.coursework.students
拥有检索作业或题目的权限并不意味着有权访问资料或资料元数据。实际上，这意味着如果管理员不是课程的成员，则可能看不到附加的云端硬盘文件的标题。如果要允许管理员访问用户文件，请参阅全网域委托指南。
管理学生的回复
StudentSubmission 资源表示学生完成的作业或题目的成绩和成绩。创建新问题或作业时，系统会为每个学生隐式创建 StudentSubmission 资源。
以下部分介绍了管理学生回复的常见操作。
检索学生回复
学生可以检索自己的提交内容，教师可以检索课程中所有学生的提交内容，网域管理员可以检索网域中所有学生的所有提交内容。系统会为每个学生提交的内容分配一个标识符；如果您知道该标识符，请使用 courses.courseWork.studentSubmissions.get 检索该标识符。
使用 courses.courseWork.studentSubmissions.list 方法获取符合某些条件的 StudentSubmission 资源，如以下示例所示：
Java
Python
通过指定 userId 参数检索属于特定学生的 StudentSubmission 资源，如以下示例所示：
Java
Python
学生由 Google Admin SDK 返回的用户唯一 ID 或电子邮件地址标识。当前用户还可以使用 "me" 简写形式引用自己的 ID。
您还可以获取学生提交的课程中所有作业的提交内容。为此，请使用字面量 "-" 作为 courseWorkId，如以下示例所示：
Java
service.courses().courseWork().studentSubmissions()
.list(courseId, "-")
.set("userId", userId)
.execute();
Python
service.courses().courseWork().studentSubmissions().list(
courseId=<course ID or alias>,
courseWorkId='-',
userId=<user ID>).execute()
所需范围取决于发出请求的用户在课程中拥有的角色。如果用户是教师或网域管理员，请使用以下范围：
https://www.googleapis.com/auth/classroom.coursework.students.readonlyhttps://www.googleapis.com/auth/classroom.coursework.students
如果用户是学生，请使用以下范围：
https://www.googleapis.com/auth/classroom.coursework.me.readonlyhttps://www.googleapis.com/auth/classroom.coursework.me
拥有检索学生提交内容的权限并不意味着有权访问附件或附件元数据。这意味着，如果管理员不是课程成员，则可能无法看到附加的云端硬盘文件的标题。如果要允许管理员访问用户文件，请参阅全网域授权指南。
在学生回复中添加附件
您可以通过附加 Link、DriveFile 或 YouTubeVideo 资源，在学生提交的作业中附加链接。这是通过 courses.courseWork.studentSubmissions.modifyAttachments 实现的，如以下示例所示：
Java
Python
链接附件由目标网址定义；Google 课堂会自动提取标题和缩略图。如需了解其他资料，请访问相应参考页面。
StudentSubmission 只能由课程教师或拥有它的学生修改。仅当学生提交的作业的 CourseWorkType 为 ASSIGNMENT 时，您才能附加 Materials。
所需范围取决于发出请求的用户在课程中拥有的角色。如果用户是教师，请使用以下范围：
https://www.googleapis.com/auth/classroom.coursework.students
如果用户是学生，请使用以下范围：
https://www.googleapis.com/auth/classroom.coursework.me
管理学生回复状态
学生的回复可能会被取消提交、上交或发回。StudentSubmission 中的状态字段指示当前状态。如需更改状态，请调用以下方法之一：
courses.courseWork.studentSubmissions.turnIncourses.courseWork.studentSubmissions.returncourses.courseWork.studentSubmissions.reclaim
所有这些方法均接受空正文。例如：
Java
Python
service.courses().courseWork().studentSubmission().turnIn(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
body={}).execute()
只有拥有 StudentSubmission 的学生才能上交或收回该作业。
只有已提交的提交内容才能被收回。课程教师只能返回处于已交状态的 StudentSubmission。
为学生的回复评分
StudentSubmission 资源有两个用于存储成绩的字段：assignedGrade（向学生报告的成绩）和 draftGrade（只有教师可以看到的暂定成绩）。这些字段使用包含相应字段的字段掩码更新 courses.courseWork.studentSubmissions.patch，如以下示例所示。
Java
Python
studentSubmission = {
'assignedGrade': 99,
'draftGrade': 80
}
service.courses().courseWork().studentSubmissions().patch(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
updateMask='assignedGrade,draftGrade',
body=studentSubmission).execute()
使用 Google 课堂界面时，教师必须先保存初始成绩，然后才能布置成绩。之后，系统会将已分配的成绩发回给学生。应用需要模拟此行为。您的应用可以通过以下两种方式之一为学生的作业评分：
仅分配
draftGrade。这非常有用，例如，可让教师在最终确定成绩之前手动检查成绩。学生无法查看初始成绩。为作业全面评分，同时布置
draftGrade和assignedGrade。
列出已布置的成绩
您可以通过探索 courses.courseWork.studentSubmissions.list 方法的响应对象列出特定课程作业的所有成绩：
Java
Python
response = coursework.studentSubmissions().list(
courseId=course_id,
courseWorkId=coursework_id,
pageSize=10).execute()
submissions.extend(response.get('studentSubmissions', []))
if not submissions:
print('No student submissions found.')
print('Student Submissions:')
for submission in submissions:
print(f"Submitted at:"
f"{(submission.get('userId'), submission.get('assignedGrade'))}")