このページでは、Classroom アドオンの設計と実装で考慮すべき一般的な誤解やエッジケースについて説明します。このようなケースをカバーするフェイルセーフとテストを実装することをおすすめします。
Google Classroom のコンセプト
このセクションでは、Google Classroom 全体に適用されるアドオンに関連するエッジケースとコンセプトについて説明します。
コース
コースは、教師と生徒を結び付ける中心的な組織部門です。以下は、Google Classroom 内のすべてのコースに適用されます。
コースの教師について:
- 1 つのコースに複数の教師が存在することがあります。
- 教師はいつでもコースに追加できます。
- 教師はいつでもコースから削除される可能性があります。
ストリーム アイテム
ストリーム アイテムは、コースのメンバーと共有される投稿コンテンツです。デベロッパーと教師は、お知らせ、課題、資料の 3 種類のストリーム アイテムにアドオンの添付ファイルを作成できます。
教師は、Classroom UI の [ストリーム] ページの上部でお知らせを作成できます。教師が課題や資料を作成するには、[授業] タブの [作成] ボタンをクリックします。デベロッパーは、Classroom API を使用して、これらの課題をプログラムで作成できます。
課題は、生徒の提出物を受け付けるストリーム アイテムです。 採点簿に表示されるストリーム アイテムでアドオン添付を含めることができるのは課題のみです。
ストリーム アイテムについて:
- 課題や資料は、コースを受講している一部の生徒に割り当てることができます。
- 課題には採点ありと採点なしがあります。教師は課題の採点ステータスを いつでも変更できます
- 課題には複数の添付ファイルを含めることができます。
- 課題にはさまざまな形式の添付ファイルが含まれていることがあります。たとえば、1 つの課題に Google ドキュメント、YouTube 動画、アドオンの添付ファイルが同時に含まれているとします。
- 1 つの課題に複数のデベロッパーのアドオンが添付されていることがあります。
- デベロッパーは、アドオン アタッチメントのいずれかを使用して、ストリーム アイテムに関する情報を取得、変更できます。
- デベロッパーは、アドオン添付ファイルのいずれかを含む課題で、生徒の提出物を提出、再利用、または返却できます。
- デベロッパーは、自分で作成した課題で、個々の生徒の提出物に成績のみを設定できます。
課題をコピーしました
教師は、コースをコピーしたり、課題を再利用したり、複数のコースに課題を公開したりして、課題をコピーできます。このようなシナリオをアドオンでどのように処理できるかについては、コピーされたコンテンツに関するページをご覧ください。