主要注意事项

本页面列出了一些常见的误解和边界情况,您在设计和实现 Google 课堂插件时可能需要考虑这些情况。建议您实现可覆盖这些情况的故障安全机制和测试。

Google 课堂概念

本部分重点介绍与适用于所有 Google 课堂的插件相关的极端情况和概念。

课程和用户角色

课程是将教师与学生联系起来的核心组织部门。课程是 Google Classroom API 中的最高级别组织。

个别用户可以以“教师”或“学生”的身份添加到课程中。用户在课程中的角色与其在所在机构中的角色无关。也就是说,学校的学生会员可以成为课程的教师,教师会员可以成为课程的学生。虽然最常见的情况是课程代表定期安排的学术主题,但也会创建课程来组织学生俱乐部或进行职业发展。

以下内容适用于 Google 课堂中的所有课程。

关于课程教师

  • 一门课程可以有多个教师。
  • 您可以随时向课程添加教师。
  • 教师可以随时从课程中移除。

信息流项

信息流内容是指与课程成员共享的已发布内容。开发者和教师可以针对以下三种信息流内容类型创建插件附件:通知、作业和资料。

教师会在 Google 课堂界面的“信息流”页面顶部创建通知。教师可以点击“课业”标签页中的创建按钮来创建作业和资料。开发者可以通过 Classroom API 以编程方式创建这些内容。

作业是可以接受学生提交的作业的流项。作业是成绩册中唯一可以包含插件附件的流式传输内容类型。

关于数据流项

  • 您可以将作业或资料分配给课程中的部分学生。
  • 作业可能会评分,也可能不计分。教师可以随时更改作业的评分状态。
  • 作业可以有多个附件。
  • 作业可以包含不同类型的附件。例如,一项作业可能同时包含 Google 文档、YouTube 视频和插件附件。
  • 作业可能包含来自多个开发者的插件附件。
  • 开发者可以使用其某个插件附件获取和修改任何信息流内容的相关信息。
  • 对于包含某个插件附件的作业,开发者可以上交、收回或发回学生提交的作业。
  • 开发者只能为学生创建的作业中的个别学生提交成绩。

已复制的直播内容

教师可以通过复制课程、重复使用作业或将信息流项发布到多门课程来复制信息流项。请参阅我们关于复制内容的指南,了解该插件如何处理这些场景。

用户所在机构

Google Classroom API 不会返回用户所在机构、楼栋或课程级别以上的任何其他成员资格的标识符。