实施策略

本页面简要介绍了插件 Web 应用和 Google 课堂插件 API 之间的主要互动。

附件查找 iframe

附件发现 iframe 是插件中教师的着陆页。建议对此视图采取以下措施：

• 当附件发现 iframe 打开时，根据 itemType 创建 courseWork.GetAddOnContextRequest、courseWorkMaterials.GetAddOnContextRequest 或 announcements.GetAddOnContextRequest 以验证用户角色并获取 supportsStudentWork 值。
• 展示您的内容发现或创作界面。您可以根据启动验证响应中的 supportsStudentWork 值省略 activity 类型的连接。
• 根据教师的选择，发出一个或多个插件 create 请求，以便在作业中添加附件。

其他 iframe

Student View iframe、Student Work Review iframe 和 Teacher View iframe 旨在向用户显示内容，而不是修改 Google 课堂作业。请考虑针对这些视图采取以下措施：

• 在 iframe 打开时，获取用户的 OAuth 同意，然后验证其角色和附件 ID。

  • 如果当前用户是学生，请将响应中的 submissionId 与学生的作业相关联。如果您要在评分工具中传回成绩以及向教师显示学生作业，则必须执行此操作；submissionIds 在所有视图上保持一致。
  • 如果插件已经知道 attachmentId，则显示相应的附件界面。
  • 否则，必须为此附件的父级帖子是从另一帖子或课程复制过来的。使用 copyHistory 标识该插件的最新副本，然后从该副本中复制设置，为插件端的附件创建新的相应模型。然后，显示相应的附件界面。
  重要提示 ：您可能会遇到极端情况；第一个访问此附件的用户可能是学生。