实施策略

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

附件发现 iframe

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

  • 展示您的内容发现或内容创建界面。

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

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

其他 iframe

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

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