本页面将简要介绍您的插件 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
确定插件知道的最新副本,并从中复制设置,以便在插件端创建相应的新附件模型。然后,显示相应的附件界面。