附件探索 iframe 是指在建立 Classroom 作業時，老師開啟外掛程式時顯示的初始檢視畫面。附件是指您希望學生互動的內容或活動。
老師可在 Classroom 課程中建立新訊息 (例如作業、公告或問題)，然後從加購項目下拉式清單中選取加購項目 (圖 1)。
圖 1. 作業建立畫面，包括老師可附加的可能外掛程式選項。
老師選取外掛程式後，Classroom 會建立附件探索 iframe，並載入外掛程式的啟動網址。任何相關的 iframe 查詢參數都會傳遞至啟動網址 (圖 2)。
圖 2. 範例：iframe 中的附件探索 UI。
您可以將「附件探索」檢視畫面視為外掛程式中老師的到達網頁。通常，老師會使用合作夥伴在 iframe 中提供的網路應用程式，選取要附加至串流項目的內容。視串流項目是公告、作業或課程教材而定，外掛程式應用程式可能會限制顯示的內容。接著，外掛程式會呼叫 Classroom API，建立並附加至作業。
老師選取並建立附件後，外掛程式會傳送 postMessage 酬載，要求關閉 iframe。iframe 關閉後，老師就會看到附件，然後可以選擇預覽附件或從作業中移除 (圖 3)。老師將串流項目指派給學生，完成建立流程。
圖 3. 建立作業時，可看到三個活動類型外掛程式附件。
使用者體驗考量事項
- 在首次開啟時，外掛程式必須提示老師登入。
- 所有 Classroom API 呼叫都必須使用 Google 單一登入功能。如果您的產品有獨立的登入系統，則必須連結帳戶。
- 老師必須能夠在 iframe 中預覽附件，才能做出最終選擇。
- 老師應能搜尋或瀏覽可附加的內容。
- 外掛程式可能會提供各種檢視畫面，例如最近的內容、我的內容，以及依學習技能篩選。
- 外掛程式必須提供從 iframe 中建立新可附加項目的功能。
如要進一步瞭解使用者體驗規定，請參閱 Classroom 外掛程式規定檢查清單。
授權狀態
如果外掛程式需要產品授權，請顯示清楚的訊息，說明沒有授權的講師如何解決這個問題。建議您隱藏或停用因授權限制而無法供老師使用的內容。