附件发现 iframe 是教师执行以下操作时显示的初始视图: 在创建 Google 课堂任务期间打开插件。一个 attachment 是您希望学生学习的内容或活动 互动
在 Google 课堂课程中,教师会创建新帖子( (例如作业、通知或题目)并从中选择一种插件, 插件下拉列表在短时间内(按小时为单位), Google 课堂允许该插件在帖子中添加附件。
图 1.浏览 创建作业,包括教师可以附加的可用插件选项。
教师选择插件后,Google 课堂会创建附件 Discovery iframe,并加载插件的启动网址。任何相关的 iframe 查询 参数传递给启动网址。
图 2. iframe 中的附件发现界面示例。
教师在 iframe 中使用合作伙伴的 Web 应用来选择
附件。应用发出 Classroom API 调用以附加附件
添加到作业中。教师选择好附件后,
插件会发送 postMessage
载荷,请求关闭 iframe。
iframe 将会关闭,教师现在可能会看到 选择预览或从作业中移除。
图 3. 包含三个活动类型插件的作业创建视图 附件。
iframe 中的用户体验注意事项
- 首次打开插件时,插件必须提示教师登录。
- 所有 Classroom API 调用都需要使用 Google 单点登录。如果 您的产品拥有独立的登录系统,您必须关联账号。
- 教师必须先能够在 iframe 中预览附件, 做出最终选择
- 教师应该能够搜索或浏览可附加 内容。
- 该插件可能会提供各种视图,例如最近的内容、我的 内容,以及按学习技能进行过滤。
- 插件必须提供通过以下工具新建可附加项的功能: 。
如需了解更多详情,请参阅 Google 课堂插件要求核对清单 用户体验要求
在 iframe 中显示许可状态
如果插件要求许可,而老师没有许可,则清晰明了 这条消息必须呈现给教师,告知他们接下来正确的 补救情况的步骤。这是为了防止 不受许可限制
此外,我们还建议您的插件:
- 在“附件发现”中显示教师的许可级别 iframe。
- 隐藏或停用因许可原因无法向教师显示的内容 级别限制。