このページでは、Classroom アドオンの設計と実装において考慮すべき一般的な誤解とエッジケースについて説明します。このような場合は、フェイルセーフを実装し、テストを行うことをおすすめします。
Google Classroom のコンセプト
このセクションでは、Google Classroom のすべてに適用されるアドオンに関連するエッジケースとコンセプトについて説明します。
コースとユーザーロール
コースは、教師と生徒をつなぐ一元的な組織部門です。コースは Google Classroom API の最上位に位置します。
個々のユーザーを「教師」または「生徒」としてコースに追加できます。コースにおけるユーザーのロールは、教育機関でのロールとは関連付けられていません。つまり、学校の生徒をコースの教師にすることも、教師をコースの生徒にすることもできるということです。最も一般的なケースは、定期的に予定されている学術テーマのコースですが、学生クラブの編成や専門能力開発の実施を目的としたコースも作成されます。
以下の内容は、Google Classroom 内のすべてのコースに適用されます。
コースの教師について:
- コースには複数の教師が参加できます。
- 教師はいつでもコースに追加できます。
- 教師はいつでもコースから削除される場合があります。
ストリーム アイテム
ストリーム アイテムとは、投稿されたコンテンツで、コースのメンバーと共有されます。デベロッパーと教師は、お知らせ、課題、資料の 3 種類のストリーム アイテムでアドオン添付ファイルを作成できます。
教師は、Classroom UI の [ストリーム] ページの上部でお知らせを作成できます。教師は [授業] タブの [作成] ボタンをクリックして、課題と資料を作成します。開発者は Classroom API を使って プログラムで作成できます
課題は、生徒の提出物を受理できるストリーム アイテムです。 採点簿に表示されるストリーム アイテムのタイプのうち、アドオンの添付ファイルを含めることができるのは、課題のみです。
ストリーム アイテムについて:
- 課題や資料は、コースの一部の生徒に割り当てることができます。
- 課題は採点済みの場合と、採点済みでない場合があります。教師は課題の採点ステータスを いつでも変更できます
- 1 つの課題に複数のファイルを添付できます。
- 課題にはさまざまな形式の添付ファイルを含めることができます。たとえば、1 つの課題で Google ドキュメント、YouTube 動画、アドオンの添付ファイルを同時に含めることができます。
- 課題に複数のデベロッパーからアドオンが添付されていることがあります。
- デベロッパーは、アドオン アタッチメントのいずれかを使用して、ストリーム アイテムに関する情報を取得し、変更できます。
- デベロッパーは、アドオン添付ファイルのいずれかを含む課題について、生徒の提出物を提出、再利用、返却できます。
- デベロッパーは、自分で作成した課題で個々の生徒の提出物に対してのみ成績を設定できます。
ストリーム アイテムをコピーしました
教師は、コースのコピー、課題の再利用、ストリーム アイテムを複数のコースに公開することで、ストリーム アイテムをコピーできます。コピーされたコンテンツに関するガイドをお読みになり、アドオンがこうしたシナリオを処理する方法をご確認ください。
ユーザーの所属機関
Google Classroom API は、ユーザーの教育機関、建物、コースレベルより上位のメンバーシップの識別子を返しません。