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