本页面简要介绍了插件 Web 应用与 Google Classroom 插件 API 之间的主要交互。
附件发现 iframe
附件发现 iframe 是插件中教师的着陆页。请考虑对此数据视图执行以下操作:
显示您的内容发现或内容创作界面。
(可选)确定流项是否接受学生的回复,因为您可能希望阻止教师添加活动类型的附件。查看插件 iframed 打开时传递的
itemType
查询参数的值。只有courseWork
类型接受学生的回答。根据教师的选择,发出一个或多个插件
create
请求,以向作业添加附件。
其他 iframe
学生视图 iframe、学生作业评价 iframe 和 教师视图 iframe 旨在向用户展示内容,而不是修改 Google 课堂作业。请考虑对这些视图执行以下操作:
- 当 iframe 打开时,获取用户的 OAuth 同意,然后验证其角色和附件 ID。
- 当 iframe 打开时,根据
itemType
创建courseWork.GetAddOnContextRequest
、courseWorkMaterials.GetAddOnContextRequest
或announcements.GetAddOnContextRequest
以验证用户角色。 - 如果当前用户是学生,请将回复中的
submissionId
与学生的作业相关联。如要在评分工具中传回成绩和向教师显示学生的作业,则必须执行此操作;视图之间会匹配submissionIds
。 - 如果该插件已经知道
attachmentId
,则显示相应的连接界面。 - 否则,必须说明该附件的父级帖子是从其他帖子或课程中复制而来。使用
copyHistory
确定插件能够识别的最新副本,并从中复制设置,以在插件端为附件创建新的相应模型。然后,显示相应的连接界面。