本页面列出了一些常见的误解和边界情况,您在设计和实现 Google 课堂插件时可能需要考虑这些情况。建议您实现可覆盖这些情况的故障安全机制和测试。
Google 课堂概念
本部分重点介绍了与适用于所有 Google 课堂的插件相关的边界情况和概念。
课程和用户角色
课程是将教师与学生联系起来的核心组织部门。课程是 Google Classroom API 中的最高级别组织。
您可以将个别用户添加为课程的“教师”或“学生”。用户在课程中的角色与其在所在机构中的角色无关。也就是说,学校的学生会员可以成为课程的教师,教师会员可以成为课程的学生。虽然最常见的情况是课程代表定期安排的课程,但课程还可用于组织学生社团或开展职业发展活动。
以下政策适用于 Google 课堂中的所有课程。
关于课程教师:
- 一门课程可以有多个教师。
- 您可以随时向课程添加教师。
- 教师可以随时从课程中移除。
信息流项
动态项是指与课程成员分享的已发布内容。开发者和教师可以为以下三种信息流内容类型创建插件附件:通知、作业和资料。
教师可以在 Google 课堂界面中“信息流”页面顶部创建通知。教师可以点击“课业”标签页中的创建按钮来创建作业和资料。开发者可以通过 Classroom API 以编程方式创建这些内容。
作业是一种可接受学生提交内容的课程内容。作业是成绩单中唯一可以包含插件附件的流式传输内容类型。
关于数据流项:
- 您可以将作业或资料分配给课程中的部分学生。
- 作业可以评分,也可以不评分。教师可以随时更改作业的评分状态。
- 作业可以有多个附件。
- 作业可以包含不同类型的附件。例如,一项作业可能同时包含 Google 文档、YouTube 视频和插件附件。
- 作业可能包含来自多个开发者的插件附件。
- 开发者可以使用其某个插件附件获取和修改任何信息流内容的相关信息。
- 如果作业包含开发者的某个插件附件,开发者可以上交、收回或退回学生提交的作业。
- 开发者只能为其创建的作业中的个别学生提交内容设置成绩。
已复制的直播内容
教师可以通过复制课程、重复使用作业或将信息流项发布到多门课程来复制信息流项。请参阅我们关于复制的内容的指南,了解该插件如何处理这些情况。
用户所在的机构
Google Classroom API 不会返回用户所在机构、楼栋或课程级别以上的任何其他成员资格的标识符。