実装戦略

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

添付ファイルの検出 iframe

添付ファイル検出 iframe は、アドオン内の教師向けのランディングページです。このビューについては、次の対応を検討してください。

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

必要に応じて、ストリームアイテムが生徒の回答を受け入れるかどうかを決定します。教師がアクティビティタイプの添付ファイルを追加できないようにします。アドオンの iframe が開かれたときに渡された 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 を表示します。