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