本页面简要介绍了插件 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
标识该插件的最新副本,然后从该副本中复制设置,为插件端的附件创建新的相应模型。然后,显示相应的附件界面。
- 如果当前用户是学生,请将响应中的