考慮すべきポイント

このページでは、よくある誤解と、注意すべきエッジケースについて説明します。 Classroom アドオンの設計と実装で考慮すべき事項について説明します。 このような場合は、フェイルセーフを実装し、テストを行うことをおすすめします。

Google Classroom のコンセプト

このセクションでは、適用されるアドオンに関連するエッジケースとコンセプトについて説明します。 アクセスできるようになります。

コースとユーザーロール

コースは、教師が 説明します。コースは Google Cloud の最上位の組織レベルで Google Classroom API。

個々のユーザーを「教師」としてコースに追加できる“生徒”ですユーザーの 教育機関での役割とは結びついていません。つまり 学校の生徒がコースの教師になり得、かつ コースの生徒もメンバーになれます。最も一般的なケースは 定期的に予定されている学習科目を表すために 用意されたコースも 生徒のクラブ活動を組織したり、専門能力開発を実施したりするためです。

以下の内容は、Google Classroom 内のすべてのコースに適用されます。

コースの教師について:

  • コースには複数の教師が参加できます。
  • 教師はいつでもコースに追加できます。
  • 教師はいつでもコースから削除される場合があります。

ストリーム アイテム

ストリーム アイテムとは、投稿されたコンテンツで、コースのメンバーと共有されます。 デベロッパーと教師は 3 つのストリーム アイテムにアドオンの添付ファイルを作成可能 お知らせ、課題、資料などです

教師は [ストリーム] ページの上部でお知らせを作成できます。 Classroom の UI。教師は以下を使用して課題や資料を作成できます。 [授業] タブの [作成] ボタンをクリックします。デベロッパーはこれらを作成可能 プログラマティックに利用できます

課題は、生徒の提出物を受理できるストリーム アイテムです。 課題は、採点簿に表示される唯一のストリーム アイテムのタイプで、 アドオン添付ファイルを含めることができます

ストリーム アイテムについて:

  • 課題や資料は、 説明します
  • 課題は採点済みの場合と、採点済みでない場合があります。教師が採点を変更できる場合があります ステータスを変更することもできます。
  • 1 つの課題に複数のファイルを添付できます。
  • 課題にはさまざまな形式の添付ファイルを含めることができます。たとえば、 課題には Google ドキュメント、YouTube 動画、アドオンの添付ファイルが含まれている場合があります。 できます。
  • 1 つの課題に複数のデベロッパーからアドオンが添付されていることがあります。
  • デベロッパーは、 表示されます。
  • デベロッパーは、生徒の提出物を提出、再利用、返却して、 アドオン添付ファイルの 1 つを含む課題が添付されています。
  • デベロッパーは、個々の生徒の提出物に対してのみ 割り当てることができます。

ストリーム アイテムをコピーしました

教師は、コースをコピーしたり、課題を再利用したりして、ストリーム アイテムをコピーできます。 ストリーム アイテムを複数のコースに公開するコピーされたコンテンツに関するガイドを読む をご覧ください。

ユーザーの所属機関

Google Classroom API はユーザーの教育機関の ID を返さない。 コースレベルより上位のメンバーシップです。