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