本頁提供外掛程式網頁應用程式與 Google Classroom 外掛程式 API 之間的主要互動總覽。
附件探索 iframe
「附件探索 iframe」是外掛程式中老師的到達網頁。建議您對這個檢視畫面採取下列行動:
- 附件探索 iframe 開啟時,根據
itemType
建立courseWork.GetAddOnContextRequest
、courseWorkMaterials.GetAddOnContextRequest
或announcements.GetAddOnContextRequest
,以驗證使用者角色並取得supportsStudentWork
值。 - 顯示內容探索或創作 UI。您可以根據啟動驗證回應中的
supportsStudentWork
值省略活動類型連結。 - 根據老師選取的項目,請提出一或多個外掛程式
create
要求以在作業中新增附件。
其他 iframe
學生檢視畫面 iframe、學生作業審查 iframe 和 老師 View iframe 都是用來向使用者顯示內容,而不是修改 Classroom 作業。建議您針對這些檢視畫面採取下列行動:
當 iframe 開啟時,取得使用者的 OAuth 同意,然後驗證其角色和連結 ID。
- 如果目前的使用者是學生,請將回應中的
submissionId
與學生作業建立關聯。您必須這麼做,才能將成績傳回給老師,並在評分工具中向老師展示學生作業;submissionIds
會跨檢視畫面進行比對。 - 如果外掛程式已得知
attachmentId
,則顯示適當的附件 UI。 - 否則,此附件的父項貼文必須從其他訊息或課程複製而來。使用
copyHistory
找出外掛程式已知的最新副本,並複製其中的設定,在外掛程式端為該連結建立新的對應模型。然後顯示適當的附件 UI。
- 如果目前的使用者是學生,請將回應中的