アタッチメント検出の iframe は、Classroom タスクの作成中にアドオンを開いたときに教師に表示される最初のビューです。添付ファイルは、生徒が操作することを意図したコンテンツまたはアクティビティです。
教師は Classroom コース内で新しい投稿（課題、お知らせ、質問など）を作成し、アドオンのプルダウン リストからアドオンを選択します（図 1）。
図 1. 教師が添付できるアドオン オプションなど、課題作成のビュー。
教師がアドオンを選択すると、Classroom は添付ファイル検出の iframe を作成し、アドオンの起動 URL を読み込みます。関連する iframe クエリ パラメータは、起動 URL に渡されます（図 2）。
図 2. iframe 内のアタッチメント検出 UI の例。
添付ファイル検出ビューは、アドオン内の教師向けのランディング ページと考えてください。通常、教師は iframe 内のパートナーのウェブ アプリケーションを使用して、ストリーミング アイテムに添付するコンテンツを選択します。アドオン アプリケーションでは、ストリーム アイテムがお知らせ、課題、コース資料のいずれであるかによって、表示されるコンテンツが制限される場合があります。アドオン アプリケーションは、Classroom API を呼び出して添付ファイルを作成し、課題に添付します。
教師が添付ファイルの選択と作成を完了すると、アドオンは iframe の閉鎖をリクエストする postMessage ペイロードを送信します。iframe が閉じられ、教師に添付ファイルが表示されます。教師は、添付ファイルをプレビューするか、課題から削除するかを選択できます（図 3）。教師は、ストリーミング アイテムを生徒に割り当てて、作成フローを完了します。
図 3. 3 つのアクティビティ タイプのアドオン アタッチメントを含む課題作成のビュー。
ユーザー エクスペリエンスに関する考慮事項
- アドオンを初めて開くときに、教師にログインを求めるメッセージが表示される必要があります。
- すべての Classroom API 呼び出しで Google シングル サインオンが必要です。商品に個別のログイン システムがある場合は、アカウントをリンクする必要があります。
- 教師は、最終的な選択を行う前に iframe 内で添付ファイルをプレビューできる必要があります。
- 教師は、添付可能なコンテンツを検索またはブラウジングできる必要があります。
- アドオンには、最近のコンテンツ、自分のコンテンツ、学習スキルによるフィルタなど、さまざまなビューが用意されている場合があります。
- アドオンは、iframe 内から新しいアタッチ可能なアイテムを作成できる必要があります。
ユーザー エクスペリエンスの要件について詳しくは、Classroom アドオンの要件チェックリストをご覧ください。
ライセンス ステータス
アドオンにプロダクトのライセンスが必要である場合は、ライセンスのない教師が状況を改善する方法を説明する明確なメッセージが表示される必要があります。ライセンス制限により教師が利用できないコンテンツを非表示または無効にすることも検討してください。