添付ファイル

添付ファイル は、ユーザーが閲覧して操作するコンテンツです。 このガイドでは、Google Classroom の添付ファイルの概要と、添付ファイルに関連する重要な用語について説明します。

アドオンの役割は、大まかに言うと、添付ファイルの作成と管理です。アドオンを使用すると、生徒は Google Classroom 内でコンテンツに直接アクセスできます。CourseWork API を使用して作成された課題とは異なり、アドオンの添付ファイルは、ユーザーが Google Classroom を離れることなく、カスタマイズされたインタラクティブなエクスペリエンスをサポートします。

教師は課題 に添付ファイルを追加します。課題には最大 10 個の添付ファイルを追加できますが、1 種類の添付ファイルは 8 個までです。添付ファイルの例としては、YouTube 動画、Google ドキュメント、外部リンクなどがあります。Google ドライブのファイルや、パソコンからアップロードしたファイルを添付することもできます。

添付カードが表示された課題作成ダイアログのビュー

図 1.添付ファイルは、課題の作成、閲覧、完了時にカードとして表示されます。

添付ファイルの種類

アドオンの添付ファイルには、アクティビティコンテンツ の 2 種類があります。 アクティビティ タイプの添付ファイルは、テストや記述式の回答など、生徒の提出や提出アクションを必要とするものです。コンテンツ タイプの添付ファイルは、動画やニュース記事など、生徒の提出を必要としない閲覧専用の資料です。

添付ファイルに関連する API のやり取りは、添付ファイルの種類によって若干異なります。アドオン API を介した添付ファイルとのやり取りについて詳しくは、添付ファイルとのやり取りのガイドページをご覧ください。

自動採点される添付ファイル

アクティビティ タイプの添付ファイルについては、採点結果を Google Classroom に返信 できます。これにより、特定の課題の採点欄に下書きの採点結果が入力されます。採点結果には、0 以上の任意の小数を入力できます。実装について詳しくは、 添付ファイルとのやり取りのガイドページをご覧ください。

これは教師から非常に要望の多い機能です。ユーザー エクスペリエンス調査では、多くの場合、アドオンアクティビティの採点結果が自動的に Google Classroom に返信されると想定していることがわかりました。

サードパーティのサイトから添付ファイルを作成する

Google Classroom の外部からプログラムでアドオンの添付ファイルを作成できます。このやり取りは、CourseWork API エンドポイントを使用して課題を作成する場合と似ています。実装について詳しくは、Google Classroomの外部で添付ファイルを作成する専用ガイドをご覧ください。