実装戦略

このページでは、アドオンウェブアプリケーションと Google Classroom アドオン API の主なやり取りの概要を説明します。

添付ファイルの検出 iframe

添付ファイルの検出 iframe は、アドオンに含まれる教師用のランディングページです。このビューに関して、次のアクションを検討してください。

コンテンツの検出または作成の UI を表示します。

必要に応じて、ストリームアイテムが生徒の回答を受け入れるかどうかを決定します。教師がアクティビティタイプの添付ファイルを追加できないようにします。アドオンの iframed が開いたときに渡された itemType クエリパラメータの値を確認します。生徒の回答を受け付けるのは courseWork タイプのみです。
教師の選択に基づいて、課題に添付ファイルを追加するアドオン create リクエストを 1 つ以上作成します。

生徒表示 iframe、生徒の提出物レビュー iframe、教師表示 iframe はすべて、Classroom の課題を変更するのではなく、ユーザーにコンテンツを表示するためのものです。これらのビューについて、次のアクションを検討してください。

iframe が開いたら、ユーザーの OAuth 同意を取得して、ロールと添付ファイル ID を検証します。
iframe が開いたら、itemType に基づいて courseWork.GetAddOnContextRequest、courseWorkMaterials.GetAddOnContextRequest、または announcements.GetAddOnContextRequest を作成し、ユーザーロールを検証します。
現在のユーザーが生徒の場合は、レスポンスの submissionId を生徒の提出物に関連付けます。これは、採点ツールで成績を渡し、教師に生徒の提出物を表示するために必要です。submissionIds はビュー間で一致します。
attachmentId がアドオンで認識されている場合は、適切なアタッチメント UI を表示します。
それ以外の場合は、この添付ファイルの親投稿が別の投稿またはコースからコピーされたものである必要があります。copyHistory を使用して、アドオンが認識している最新のコピーを特定し、その設定をコピーして、アドオン側のアタッチメントに対応する新しいモデルを作成します。次に、適切なアタッチメント UI を表示します。