实施策略

本页面简要介绍了插件 Web 应用与 Google Classroom 插件 API 之间的主要交互。

附件发现 iframe

附件发现 iframe 是插件中教师的着陆页。请考虑对此数据视图执行以下操作:

  • 显示您的内容发现或内容创作界面。

    (可选)确定流项是否接受学生的回复,因为您可能希望阻止教师添加活动类型的附件。查看插件 iframed 打开时传递的 itemType 查询参数的值。只有 courseWork 类型接受学生的回答。

  • 根据教师的选择,发出一个或多个插件 create 请求,以向作业添加附件。

其他 iframe

学生视图 iframe学生作业评价 iframe教师视图 iframe 旨在向用户展示内容,而不是修改 Google 课堂作业。请考虑对这些视图执行以下操作:

  • 当 iframe 打开时,获取用户的 OAuth 同意,然后验证其角色和附件 ID。
  • 当 iframe 打开时,根据 itemType 创建 courseWork.GetAddOnContextRequestcourseWorkMaterials.GetAddOnContextRequestannouncements.GetAddOnContextRequest 以验证用户角色。
  • 如果当前用户是学生,请将回复中的 submissionId 与学生的作业相关联。如要在评分工具中传回成绩和向教师显示学生的作业,则必须执行此操作;视图之间会匹配 submissionIds
  • 如果该插件已经知道 attachmentId,则显示相应的连接界面。
  • 否则,必须说明该附件的父级帖子是从其他帖子或课程中复制而来。使用 copyHistory 确定插件能够识别的最新副本,并从中复制设置,以在插件端为附件创建新的相应模型。然后,显示相应的连接界面。