附件发现 iframe

附件发现 iframe 是教师在创建 Google 课堂作业期间打开插件时看到的初始视图。附件是指您希望学生与之互动的内容或活动。

教师在 Google 课堂课程中创建新帖子（例如作业、通知或题目），然后从插件下拉列表中选择插件。在短时间内（大约几个小时），Google 课堂会允许该插件向帖子添加附件。

图 1. 显示作业创建过程的视图，其中包括教师可以附加的可能插件选项。

教师选择插件后，Google 课堂会创建一个“附件发现”iframe，并加载该插件的启动网址。所有相关的 iframe 查询参数都会传递给启动网址。

图 2. iframe 中的附件发现界面示例。

教师在 iframe 中使用合作伙伴的 Web 应用选择附件。应用会调用 Google 课堂 API 以将附件附加到作业。教师选择完附件后，该插件会发送 postMessage 载荷，请求关闭 iframe。

iframe 会关闭，教师现在可以看到附件，并可以选择预览或从作业中移除附件。

图 3. 显示创建的包含三个活动类型插件附件的作业。

iframe 中的用户体验注意事项

• 在首次打开时，该插件必须提示教师登录。
• 所有 Google 课堂 API 调用都需要使用 Google 单点登录。如果您的商品使用单独的登录系统，您必须关联账号。
• 教师必须能够在 iframe 中预览附件，然后才能做出最终选择。
• 教师应能够搜索或浏览可附加的内容。
• 该插件可以提供各种视图，例如近期内容、我的内容和按学习技能过滤。
• 该插件必须提供从 iframe 中创建新的可附加项的功能。

如需详细了解用户体验要求，请参阅 Google 课堂插件要求核对清单。

在 iframe 中显示许可状态

如果插件需要许可证，而教师没有许可证，则必须向教师显示一条明确的消息，告知他们采取适当的后续措施来解决此问题。这是为了避免因许可限制而产生任何混淆。

我们还建议您的插件：

• 在“附件发现”iframe 中显示教师的执照级别。
• 隐藏或停用因许可级别限制而无法供教师使用的资源。