導入策略

本頁面簡要說明外掛程式網頁應用程式與 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。