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