「附件探索 iframe」是老師在建立 Classroom 工作期間開啟外掛程式時的初始檢視畫面。附件是您希望學生互動的內容或活動。
老師在 Classroom 課程中建立新訊息 (例如作業、公告或問題)，然後從外掛程式下拉式清單中選取外掛程式。短期內 (以小時為單位)，Classroom 允許外掛程式在訊息中新增附件。
圖 1.查看作業建立流程，包括老師可以附加的可能外掛程式選項。
老師選取外掛程式後，Classroom 會建立附件探索 iframe，並載入外掛程式的啟動網址。所有相關的 iframe 查詢參數都會傳送至啟動網址。
圖 2. iframe 中的附件探索使用者介面範例。
老師會在 iframe 內使用合作夥伴的網頁應用程式選取連結。應用程式會發出 Classroom API 呼叫，以將附件附加到作業中。老師選取附件後，外掛程式會傳送 postMessage 酬載要求關閉 iframe。
iframe 隨即關閉，老師現在可能會看到自己選擇預覽或從作業中移除的附件。
圖 3. 查看含有三個活動類型外掛程式附件的作業建立情形。
iframe 內的使用者體驗注意事項
- 首次開啟時，外掛程式必須提示老師登入。
- 所有 Classroom API 呼叫都必須使用 Google 單一登入功能。如果產品有不同的登入系統，您必須連結帳戶。
- 老師必須先在 iframe 中預覽附件，才能做出最終選取。
- 老師應能搜尋或瀏覽可附加的內容。
- 這個外掛程式可能會提供各種檢視畫面，例如近期內容、我的內容，以及依學習技能篩選內容。
- 外掛程式必須讓使用者能在 iframe 中建立新的可附加項目。
如要進一步瞭解使用者體驗規定，請參閱 Classroom 外掛程式規定檢查清單。
在 iframe 中顯示授權狀態
如果外掛程式需要授權，且老師沒有授權，系統「必須」向老師顯示明確訊息，通知對方可採取的後續步驟來解決問題。這是為了避免因授權限制引起的混淆。
此外，我們也建議您使用以下外掛程式：
- 在 附件探索 iframe 中顯示老師的授權層級。
- 隱藏或停用因授權層級限製而無法取得的內容。