附件发现 iframe 是教师在创建 Google 课堂任务期间打开插件时向教师显示的初始视图。附件是您希望学生与之互动的内容或活动。
教师在 Google 课堂课程中创建新帖子（例如作业、通知或题目），然后从插件下拉列表中选择插件。在短时间内（大约几个小时），Google 课堂会允许该插件向帖子添加附件。
图 1. 查看作业创建情况，包括教师可以附加的可用插件选项。
教师选择插件后，Google 课堂会创建一个“附件发现”iframe，并加载该插件的启动网址。所有相关的 iframe 查询参数都会传递到启动网址。
图 2. iframe 中的附件发现界面示例。
教师在 iframe 中使用合作伙伴的 Web 应用选择附件。应用会调用 Google 课堂 API 以将附件附加到作业。教师选择完附件后，该插件会发送 postMessage 载荷，请求关闭 iframe。
iframe 会关闭，教师现在可以选择预览附件或从作业中移除附件。
图 3. 显示包含三个 activity 类型插件附件的分配创建视图。
iframe 中的用户体验注意事项
- 在首次打开时，该插件必须提示教师登录。
- 所有 Classroom API 调用都需要使用 Google 单点登录。如果您的商品使用单独的登录系统，您必须关联账号。
- 在做出最终选择之前，教师必须能够在 iframe 中预览附件。
- 教师应能够搜索或浏览可附加的内容。
- 该插件可以提供各种视图，例如近期内容、我的内容和按学习技能过滤。
- 该插件必须提供在 iframe 中创建新的可附加项的功能。
如需详细了解用户体验要求，请参阅 Google 课堂插件要求核对清单。
在 iframe 中显示许可状态
如果插件需要许可证，而教师没有许可证，则必须向教师显示一条明确的消息，告知他们采取适当的后续措施来解决此问题。这是为了防止许可限制可能引起的混淆。
我们还建议您的插件：
- 在附件发现 iframe 中显示教师的许可级别。
- 隐藏或停用因许可级别限制而无法供教师使用的资源。