重要考量事項:

本頁面列出一些常見的誤解和極端情況,建議您在設計及實作 Classroom 外掛程式時多加留意。建議您針對這些情況導入故障安全機制和測試。

Google Classroom 概念

本節著重說明所有 Google Classroom 都適用的外掛程式相關邊緣案例和概念。

課程和使用者角色

「課程」是能夠讓老師與學生交流互動的中央機構單位。課程是 Google Classroom API 中的最高組織層級。

系統可能會將個別使用者新增為課程的「老師」或「學生」。課程中使用者的角色不會與其在機構中的角色相關聯。因此,校內學生可以是課程的老師,老師則屬於課程的學生。雖然最常見的情況是代表定期排定的學術主題課程,但我們也建立了課程來規劃學生社團或進行專業培訓。

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

關於課程老師

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

訊息串項目

「訊息串項目」是與課程成員分享的貼文。開發人員和老師可以用三種串流項目類型建立外掛程式附件:公告、作業和教材。

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

「作業」是一種訊息串項目,可接受學生繳交的作業。在成績單中,作業是唯一可包含外掛程式附件的串流項目類型。

關於串流項目

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

已複製串流項目

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

使用者的機構

Google Classroom API 不會傳回使用者機構、建築物,或課程等級以上的任何其他成員資格 ID。