重要考量事項:

本頁面列出一些常見的誤解和極端情況,您在設計及導入 Classroom 外掛程式時,不妨考量這些情況。建議您實作涵蓋這些情況的安全防護措施和測試。

Google Classroom 概念

本節會說明極端情況,以及適用於所有 Google Classroom 的擴充功能相關概念。

課程和使用者角色

課程是連結老師與學生的核心組織單位。課程是 Google Classroom API 中最高層級的組織。

個別使用者可新增為「老師」或「學生」加入課程。使用者在課程中的角色與其在機構中的角色無關。也就是說,學校的學生成員可以擔任課程老師,而老師成員則可擔任課程學生。雖然課程最常用於代表定期安排的學科,但也用於安排學生社團或進行專業培訓。

下列規定適用於 Google Classroom 中的所有課程。

關於課程老師

  • 課程可能有多位老師。
  • 老師隨時可以加入課程。
  • 老師隨時可以從課程中移除。

串流項目

串流項目是指與課程成員分享的內容。開發人員和老師可以在三種訊息串項目類型 (公告、作業和教材) 上建立外掛程式附件。

老師可以在 Classroom UI 的「訊息串」頁面頂端建立公告。老師只要在「課堂作業」分頁中按一下「建立」按鈕,即可建立作業和教材。開發人員可以透過 Classroom API 以程式輔助方式建立這些項目。

作業是可接受學生提交內容的串流項目。作業是唯一會顯示在成績單中,且可包含外掛程式附件的串流項目類型。

關於串流項目

  • 作業或教材可以指派給課程中的部分學生。
  • 作業可以評分或不評分。老師隨時可以變更作業的評分狀態。
  • 作業可以有多個附件。
  • 作業可能包含不同類型的附件。舉例來說,一項作業可能同時包含 Google 文件、YouTube 影片和外掛程式附件。
  • 作業可能有多位開發人員提供的附加元件。
  • 開發人員可以透過其中一個外掛程式附件,取得及修改任何串流項目的相關資訊。
  • 開發人員可以針對含有其中一個外掛程式附件的作業,繳交、取回或退回學生提交的內容。
  • 開發人員只能針對自己建立的作業,為個別學生繳交的作業設定成績。

已複製的串流項目

老師可以複製課程、重複使用作業,或是將串流項目發布至多門課程,以複製串流項目。請參閱複製內容指南,瞭解外掛程式如何處理這些情況。

使用者所屬機構

Google Classroom API 不會傳回使用者機構、大樓或任何其他會員身分 (高於課程層級) 的 ID。