アタッチメント検出の 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 内に教師のライセンスレベルが表示されます。
- ライセンス レベルの制限により教師が利用できないコンテンツを非表示または無効にします。