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