添付ファイルは、ユーザーが表示して操作するコンテンツです。このガイドでは、Google Classroom の添付ファイルの概要と、添付ファイルに関連する重要な用語について説明します。
大まかに言うと、アドオンの役割はアタッチメントの作成と管理です。アドオンを使用すると、生徒は Google Classroom 内でコンテンツに直接アクセスできます。アドオンの添付ファイルは、CourseWork API を使用して作成された課題とは異なり、ユーザーが Google Classroom を離れることなく、カスタマイズされたインタラクティブな課題をサポートします。
教師が課題に添付ファイルを追加できます。1 つの割り当てには最大 10 個の添付ファイルを含めることができますが、1 つのタイプにつき最大で 8 個です。添付ファイルの例としては、YouTube 動画、Google ドキュメント、外部リンクなどがあります。Google ドライブにあるファイルやパソコンからアップロードしたファイルを添付することもできます。
図 1. 添付ファイルは、課題の作成、表示、完了時にカードとして表示されます。
添付ファイルの種類
アドオンの添付ファイルには、アクティビティとコンテンツの 2 種類があります。アクティビティ タイプの添付ファイルは、クイズや書面による回答など、生徒による提出や提出が必要なすべての添付ファイルです。コンテンツ タイプの添付ファイルは、動画やニュース記事など、学生による提出が不要な表示専用の資料です。
添付ファイル関連の API の操作は、添付ファイルの種類によって若干異なります。アドオン API を使用した添付ファイルの操作の詳細については、添付ファイルの操作のガイドページをご覧ください。
自動採点の添付ファイル
アクティビティの種類に応じた添付ファイルについては、Google Classroom に成績を返すことができます。これにより、特定の課題の成績フィールドに仮成績が入力されます。成績は 0 以上の任意の 10 進数で指定できます。実装の詳細については、添付ファイルの操作に関するガイドをご覧ください。
なお、この機能は教師から特にご要望の多かった機能です。Google のユーザー エクスペリエンス調査によると、多くの教師がアドオン アクティビティの成績は自動的に Google Classroom に返却されることを想定しています。
サードパーティのサイトから添付ファイルを作成する
Google Classroom の外部からプログラムでアドオンの添付ファイルを作成できます。操作は、CourseWork API エンドポイントを使用した課題の作成と似ています。実装の詳細については、Google Classroom の外部で添付ファイルを作成するの専用のガイドをご覧ください。