このページでは、Classroom アドオンの設計と実装時に考慮すべき、一般的な誤解とエッジケースについて説明します。このようなケースをカバーするフェイルセーフとテストを実装することをおすすめします。
Google Classroom の概念
このセクションでは、Google Classroom 全体に適用されるアドオンに関連するエッジケースとコンセプトについて説明します。
コースとユーザーロール
コースは、教師と生徒をつなぐ中心的な組織単位です。コースは、Google Classroom API の最上位の組織です。
個々のユーザーは、コースに「教師」または「生徒」として追加できます。コースでのユーザーの役割は、教育機関での役割とは関係ありません。つまり、学校の生徒メンバーはコースの教師になることができます。また、教師メンバーはコースの生徒になることができます。コースは、定期的にスケジュールされる学術科目を表すことが最も一般的ですが、学生クラブを組織したり、職業能力開発を行うために作成されることもあります。
以下の内容は、Google Classroom 内のすべてのコースに適用されます。
コースの教師について:
- 1 つのコースに複数の教師が割り当てられることもあります。
- 教師はいつでもコースに追加できます。
- 教師はコースからいつでも削除される可能性があります。
ストリーム アイテム
ストリーム アイテムは、コースのメンバーと共有される投稿されたコンテンツの一部です。デベロッパーと教師は、お知らせ、課題、資料の 3 種類のストリーム アイテムにアドオンの添付ファイルを作成できます。
教師は、Classroom UI の [ストリーム] ページの上部でお知らせを作成します。教師は、[課題] タブの [作成] ボタンをクリックして課題と資料を作成します。デベロッパーは、Classroom API を使用してプログラムでこれらのファイルを作成できます。
課題は、生徒の提出を受け付けることができるストリーミング アイテムです。課題は、成績評価に表示されるストリーム アイテムの唯一の種類で、アドオンの添付ファイルを含めることができます。
ストリーム アイテムについて:
- 課題や資料は、コース内の一部の生徒に割り当てることができます。
- 課題は採点対象または採点対象外です。教師は課題の採点ステータスをいつでも変更できます。
- 課題には複数の添付ファイルを設定できます。
- 課題には、さまざまな種類の添付ファイルが含まれている場合があります。たとえば、1 つの課題に Google ドキュメント、YouTube 動画、アドオンの添付ファイルを同時に含めることができます。
- 課題には、複数のデベロッパーによるアドオンの添付ファイルが含まれている場合があります。
- デベロッパーは、アドオンの添付ファイルを使用して、任意のストリーム アイテムに関する情報を取得および変更できます。
- デベロッパーは、アドオンの添付ファイルが含まれている課題の生徒の提出物を提出、再利用、返却できます。
- デベロッパーは、作成した課題で生徒の個々の提出物にのみ成績を設定できます。
コピーされたストリーム アイテム
教師は、コースのコピー、課題の再利用、ストリーム アイテムの複数のコースへの公開によって、ストリーム アイテムをコピーできます。アドオンがこれらのシナリオをどのように処理するかについては、コピーされたコンテンツに関するガイドをご覧ください。
ユーザーの機関
Google Classroom API は、ユーザーの教育機関、建物、コースレベルを超えるその他のメンバーシップの ID を返しません。