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