附件发现 iframe

附件发现 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。
  • 隐藏或停用因许可原因无法向教师显示的内容 级别限制。