添付ファイルの検出 iframe は、Classroom のタスクの作成時にアドオンを開いたときに教師に表示される最初のビューです。添付ファイルは、生徒がやり取りを予定しているコンテンツまたはアクティビティです。
Classroom のコース内で、教師が新しい投稿（課題、お知らせ、質問など）を作成し、アドオンのプルダウン リストからアドオンを選択します。Classroom では短時間（数時間程度）の間、アドオンで投稿に添付ファイルを追加できます。
図 1.課題作成画面。教師が添付できるアドオンの候補が表示されています。
教師がアドオンを選択すると、Classroom によって添付ファイルの検出 iframe が作成され、アドオンの起動 URL が読み込まれます。関連する iframe クエリ パラメータがすべて起動 URL に渡されます。
図 2. iframe 内のアタッチメントの検出 UI の例。
教師は、iframe 内でパートナーのウェブ アプリケーションを使用して、添付ファイルを選択します。アプリでは Classroom API を呼び出して添付ファイルを
課題に添付します。教師がアタッチメントの選択を完了すると、アドオンは iframe の終了をリクエストする postMessage ペイロードを送信します。
iframe が閉じて、教師が添付ファイルを表示できるようになります。教師は、その添付ファイルをプレビューするか、課題から削除するかを選択できます。
図 3. 3 つのアクティビティ タイプのアドオン アタッチメントがある課題作成のビュー。
iframe 内の UX に関する考慮事項
- アドオンを最初に開いたときに、教師にログインを求めるメッセージが表示されます。
- すべての Classroom API 呼び出しに Google シングル サインオンが必要です。サービスに個別のログイン システムがある場合は、アカウントをリンクする必要があります。
- 最終選択を行う前に、教師が iframe 内で添付ファイルをプレビューできる必要があります。
- 教師は、添付可能なコンテンツを検索またはブラウジングできる必要があります。
- このアドオンでは、最近のコンテンツ、自分のコンテンツ、学習スキルによるフィルタなど、さまざまなビューを利用できます。
- アドオンでは、iframe 内から接続可能な新しいアイテムを作成する機能を提供する必要があります。
UX の要件について詳しくは、Classroom アドオンの要件のチェックリストをご覧ください。
iframe 内にライセンス ステータスを表示する
アドオンにライセンスが必要で、教師にライセンスがない場合は、状況を是正するための適切な次のステップを知らせる明確なメッセージを教師に表示する必要があります。これは、ライセンスの制限によって生じる混乱を防ぐためです。
また、以下を行うことをおすすめします。
- 添付ファイル ディスカバリの iframe 内に教師のライセンス レベルが表示されます。
- ライセンス レベルの制限により教師が利用できないコンテンツを非表示にするか、無効にします。