本页面列出了在设计和实现 Google 课堂插件时可能需要考虑的一些常见误解和极端情况。建议您实现涵盖这些情况的故障保险和测试。
Google 课堂概念
本部分重点介绍与适用于所有 Google 课堂的插件相关的极端情况和概念。
课程和用户角色
课程是连接教师与学生的中心组织部门。课程是 Google Classroom API 中整个组织结构的最高层级。
个别用户可以以“教师”或“学生”的身份添加到课程中。用户在课程中的角色与他们在其机构中的角色无关。这意味着学校的学生成员可以是课程中的教师，而教师成员可以是课程中的学生。虽然最常见的情况是课程代表定期安排的学术主题，但也会创建课程来组织学生俱乐部或进行职业发展。
以下内容适用于 Google 课堂中的所有课程。
关于课程教师：
- 一门课程可以有多个教师。
- 您可以随时将教师添加到课程中。
- 教师可以随时从课程中移除。
信息流内容
信息流内容是指与课程成员共享的已发布内容。开发者和教师可以针对三种流项目类型（通知、作业和资料）创建插件附件。
教师会在 Google 课堂界面的“信息流”页面顶部创建通知。教师可以点击“课业”标签页中的创建按钮来创建作业和资料。开发者可以通过 Classroom API 以编程方式创建这些信息。
作业是可以接受学生提交的作业的流项。“作业”是成绩册中显示的唯一一种可以包含插件附件的流项目。
关于信息流内容：
- 可以将作业或资料分配给课程中的一部分学生。
- 作业可能会评分，也可能不计分。教师可以随时更改作业的评分状态
- 一份作业可以有多个附件。
- 作业可能包含不同类型的附件。例如，一个作业可以同时包含 Google 文档、YouTube 视频和插件附件。
- 一项作业可能会包含来自多位开发者的插件附件。
- 开发者可以通过某个插件附件获取和修改任何流项的相关信息。
- 对于包含某个插件附件的作业，开发者可以上交、收回或发回学生提交的作业。
- 开发者只能为学生创建的作业中的个别学生提交成绩。
已复制信息流内容
教师可以通过复制课程、重复使用作业或将流内容发布到多个课程来复制流内容。请参阅我们关于复制内容的指南，了解该插件如何处理这些场景。
用户所在机构
Google Classroom API 不会返回用户的机构、建筑物或课程级别之上的任何其他会员的标识符。