実装戦略

このページでは、アドオンウェブアプリケーションと 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 を表示します。