本頁面列出一些常見的誤解和極端情況,您在設計及導入 Classroom 外掛程式時,不妨考量這些情況。建議您實作涵蓋這些情況的安全防護措施和測試。
Google Classroom 概念
本節會說明極端情況,以及適用於所有 Google Classroom 的擴充功能相關概念。
課程和使用者角色
課程是連結老師與學生的核心組織單位。課程是 Google Classroom API 中最高層級的組織。
個別使用者可新增為「老師」或「學生」加入課程。使用者在課程中的角色與其在機構中的角色無關。也就是說,學校的學生成員可以擔任課程老師,而老師成員則可擔任課程學生。雖然課程最常用於代表定期安排的學科,但也用於安排學生社團或進行專業培訓。
下列規定適用於 Google Classroom 中的所有課程。
關於課程老師:
- 課程可能有多位老師。
- 老師隨時可以加入課程。
- 老師隨時可以從課程中移除。
串流項目
串流項目是指與課程成員分享的內容。開發人員和老師可以在三種訊息串項目類型 (公告、作業和教材) 上建立外掛程式附件。
老師可以在 Classroom UI 的「訊息串」頁面頂端建立公告。老師只要在「課堂作業」分頁中按一下「建立」按鈕,即可建立作業和教材。開發人員可以透過 Classroom API 以程式輔助方式建立這些項目。
作業是可接受學生提交內容的串流項目。作業是唯一會顯示在成績單中,且可包含外掛程式附件的串流項目類型。
關於串流項目:
- 作業或教材可以指派給課程中的部分學生。
- 作業可以評分或不評分。老師隨時可以變更作業的評分狀態。
- 作業可以有多個附件。
- 作業可能包含不同類型的附件。舉例來說,一項作業可能同時包含 Google 文件、YouTube 影片和外掛程式附件。
- 作業可能有多位開發人員提供的附加元件。
- 開發人員可以透過其中一個外掛程式附件,取得及修改任何串流項目的相關資訊。
- 開發人員可以針對含有其中一個外掛程式附件的作業,繳交、取回或退回學生提交的內容。
- 開發人員只能針對自己建立的作業,為個別學生繳交的作業設定成績。
已複製的串流項目
老師可以複製課程、重複使用作業,或是將串流項目發布至多門課程,以複製串流項目。請參閱複製內容指南,瞭解外掛程式如何處理這些情況。
使用者所屬機構
Google Classroom API 不會傳回使用者機構、大樓或任何其他會員身分 (高於課程層級) 的 ID。