このページでは、アドオン ウェブ アプリケーションと Google Classroom アドオン API の主なやり取りの概要を説明します。
添付ファイルの検出 iframe
添付ファイルの検出 iframe は、アドオンに含まれる教師用のランディング ページです。このビューに関して、次のアクションを検討してください。
コンテンツの検出または作成の UI を表示します。
必要に応じて、ストリーム アイテムが生徒の回答を受け入れるかどうかを決定します。教師がアクティビティ タイプの添付ファイルを追加できないようにします。アドオンの iframed が開いたときに渡された
itemType
クエリ パラメータの値を確認します。生徒の回答を受け付けるのはcourseWork
タイプのみです。教師の選択に基づいて、課題に添付ファイルを追加するアドオン
create
リクエストを 1 つ以上作成します。
その他の iframe
生徒表示 iframe、生徒の提出物レビュー iframe、教師表示 iframe はすべて、Classroom の課題を変更するのではなく、ユーザーにコンテンツを表示するためのものです。これらのビューについて、次のアクションを検討してください。
- iframe が開いたら、ユーザーの OAuth 同意を取得して、ロールと添付ファイル ID を検証します。
- iframe が開いたら、
itemType
に基づいてcourseWork.GetAddOnContextRequest
、courseWorkMaterials.GetAddOnContextRequest
、またはannouncements.GetAddOnContextRequest
を作成し、ユーザーロールを検証します。 - 現在のユーザーが生徒の場合は、レスポンスの
submissionId
を生徒の提出物に関連付けます。これは、採点ツールで成績を渡し、教師に生徒の提出物を表示するために必要です。submissionIds
はビュー間で一致します。 attachmentId
がアドオンで認識されている場合は、適切なアタッチメント UI を表示します。- それ以外の場合は、この添付ファイルの親投稿が別の投稿またはコースからコピーされたものである必要があります。
copyHistory
を使用して、アドオンが認識している最新のコピーを特定し、その設定をコピーして、アドオン側のアタッチメントに対応する新しいモデルを作成します。次に、適切なアタッチメント UI を表示します。