導入策略

本頁提供外掛程式網頁應用程式與 Google Classroom 外掛程式 API 之間主要互動的簡介。

附件探索 iframe

附件探索 iframe 是外掛程式中老師的到達網頁,建議您對這個資料檢視採取下列動作:

  • 顯示內容探索或創作 UI。

    (選用) 決定串流項目是否接受學生回應,因為您可能想防止老師新增活動類型附件。檢查外掛程式 iframe 開啟時傳送的 itemType 查詢參數值。只有 courseWork 類型可以接受學生的回應。

  • 根據老師的選擇,發出一或多個 create 要求來為作業新增附件。

其他 iframe

「學生檢視 iframe」學生工作評論 iframe教師檢視畫面 iframe 都是要向使用者顯示內容,而非修改 Classroom 作業。建議您針對這些檢視畫面採取下列動作:

  • iframe 開啟時,請取得使用者的 OAuth 同意,然後驗證他們的角色和附件 ID。
  • iframe 開啟時,請根據 itemType 建立 courseWork.GetAddOnContextRequestcourseWorkMaterials.GetAddOnContextRequestannouncements.GetAddOnContextRequest,以驗證使用者角色。
  • 如果目前的使用者是學生,請將回覆的 submissionId 與學生作業建立關聯。如要傳回成績,以及在評分工具中向老師顯示學生作業,就必須這麼做;submissionIds 會比對各個檢視畫面。
  • 如果 attachmentId 已是外掛程式,顯示適用的連結 UI。
  • 否則,這個連結的父項訊息可能從其他貼文或課程複製而來。使用 copyHistory 找出外掛程式識別的最新副本,然後從中複製設定,在外掛程式端建立新的對應連結模型。然後顯示相應的附件 UI。