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