实施策略

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

附件发现 iframe

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

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

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

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

其他 iframe

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

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