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