添付ファイルを操作する

このページでは、添付ファイルの作成および作成のための実装の詳細について説明します。 生徒の提出物を操作できます必要に応じて、 attachment 関連のパラメータを使用してください。

アタッチメントの作成

アタッチメントを作成するには、CREATE リクエストを適切な courses.*.addOnAttachments.create エンドポイント。リクエストには リクエスト本文の AddOnAttachment のインスタンス。

添付ファイルを作成する際は、次のフィールドが必要です。

  • title: アタッチメントの文字列名。
  • teacherViewUri: アタッチメントの教師用のビューの URI。
  • studentViewUri: アタッチメントの生徒用のビューの URI。
  • studentWorkReviewUri: 教師が生徒の課題を表示する URI 表示されます。このフィールドは、アクティビティ タイプの添付ファイルにのみ必須です。

次のオプション フィールドの一部を含めることをおすすめします。

  • アタッチメントの期限を指定する場合は、dueDate と dueTime。
  • maxPoints: 添付ファイルの最大成績。ゼロ以外の値を指定してください 成績の送信をサポートする場合。アクティビティ タイプの添付ファイルに適用されます のみです。

これらのフィールドの詳細については、AddOnAttachment リソースのリファレンスをご覧ください。

生徒の提出物の詳細

一般的な提出ワークフローの手順は以下のとおりです。

  1. 生徒が studentViewUri を起動してアクティビティを完了します。
  2. アドオンが getAddOnContext メソッドから submissionId を取得する 生徒の認証情報を使用します。
  3. submissionId と attachmentId はアドオンによって保存されます。 作成者を生徒の提出物の一意の識別子として使用します。もし 教師が Classroom で課題をコピーすると、 複合キーを追加して、新しい添付ファイルを 課題をコピーしました。詳しくは、コピーされたコンテンツに関するページをご覧ください。
  4. 生徒の提出物の確認に興味がある教師は、 studentWorkReviewUri。このリクエストには、次のクエリ パラメータが含まれます。 courseId、itemId、itemType、attachmentId、submissionId。
  5. アドオン デベロッパーは、この 4 つの ID を使用して生徒の提出物を取得します。使用 courses.courseWork.addOnAttachments.studentSubmissions エンドポイント 生徒の提出物に関する情報の取得や変更
で確認できます。

送信状態を検出する

GET リクエストの発行先: 取得する courses.courseWork.addOnAttachments.studentSubmissions エンドポイント 特定の submissionId に関する詳細情報を取得します。通知を受け取ります。 AddOnAttachmentStudentSubmission オブジェクト。これには、提出物の成績が含まれます。 （pointsEarned）と現在のステータス（postSubmissionState）。送信状態 次のいずれかの値です。

  • NEW: 生徒が提出物にアクセスしたことがない場合。
  • CREATED: 生徒が提出物を作成したものの、まだ提出していない場合。
  • TURNED_IN: 生徒が教師に課題を提出済みの場合。
  • RETURNED: 教師が提出物を生徒に返却した場合。
  • RECLAIMED_BY_STUDENT（生徒が提出を取り消し済みの場合）しています。

このエンドポイントを使用して、アドオンでの生徒の課題の状態を検出します。マイページ 目標に応じて、生徒に表示されるビューやオプションを 状態が返されます。たとえば、次のような機能があります。

  • アドオン内の課題の提出状況を表示する。このため、 生徒が混乱を招かないようにし、生徒が誤って 失敗します。
  • 投稿の編集権限を制限する。課題のステータス CREATED または RECLAIMED_BY_STUDENT: 生徒に編集が許可されている場合があります 予測します。課題のステータスが TURNED_IN または RETURNED の場合、 生徒が提出物を編集できない可能性があります。

成績と複数の添付ファイル

成績の設定に使用できるアドオンの添付ファイルは 1 つのみです。 割り当てます。教師がアクティビティ タイプの添付ファイルを複数作成し、 maxPoints 値を指定すると、最初のアタッチメントでのみ 評価します。maxPoints の値を未設定のままにするか、ゼロに設定するか、 添付ファイルの成績の送信を無効にする。

提出物の成績を設定する

生徒の提出物を変更するには、PATCH リクエストを courses.courseWork.addOnAttachments.studentSubmissions エンドポイント。リクエスト 本文には AddOnAttachmentStudentSubmission のインスタンスと、 示されます。提出物の成績を変更するには、pointsEarned フィールドを設定します。 pointsEarned で渡された値は仮成績となり、 Classroom UI で教師と表示されます。教師は仮成績を変更できる 生徒に課題を返却する前に確認します。採点機能の概要 Classroom の UI: 成績の詳細 説明します。

pointsEarned で成績を設定できるのは、次の場合のみです。 true:

  • アタッチメントには正の maxPoints 値を指定する必要があります。
  • アドオンは添付ファイルの元の作成者である必要があります。

また、作成済みの AddOnAttachment の maxPoints を変更することもできます。 addOnAttachments エンドポイントに PATCH リクエストを送信して値。

成績を設定するタイミング

成績を Google Classroom にいつ返すかは、管理者が選択できます。「 重要な違いは、教師の認証情報を保存するかどうかです。たとえば、 教師だけが成績を変更できます。

採点試験は次の 2 つの段階に分けられます。 Google Classroom: 生徒が課題を完了したとき、または教師が [生徒の提出物の確認] iframe で生徒の課題を開きます。

生徒が課題を完了したら、成績を設定する場合は、 教師のオフライン認証情報を取得し、取得した認証情報を使用して成績を変更する 生徒が課題を完了したら、この方法では メリット:

  • 成績をシームレスに更新できる。教師は、特別な Classroom の UI に成績が入力されます。
  • 課題を通じてクラスの進捗状況をリアルタイムで分析する。 生徒が添付ファイルを完了したときに成績を設定すると、教師は 生徒の学習意欲を理解しておくことが重要です。

なお、この方法では、非同期のアプローチで採点することもできます。 同期できます。定期的に AddOnAttachmentStudentSubmission をポーリングできます。 エンドポイントを使用して、生徒が課題を提出したことを検出します。移行のタイミング 保存されている認証情報を使用して提出物の成績を設定します。

生徒のセッション中に教師の認証情報を読み込まない場合は、 アクティブな教師の認証情報を使用して、アクティブな教師の認証情報を 生徒の提出物の確認の iframe で提出してください。ただし、この方法では Classroom UI で採点する際のユーザー エクスペリエンスが特にスムーズになります。 リアルタイムで更新されないため、教師は毎回 生徒の提出物の確認の iframe。

課題の成績の変化を検出する

教師は Google Chat で成績の設定を編集できます。 課題の作成後に Classroom にアクセスする。このような編集は、 含める:

  • 割り当てられた点数を変更する。
  • 割り当ての maxPoints 値の変更。
  • 課題を採点するかどうかの変更。

課題の現在の採点設定を確認するには、 courses.courseWork エンドポイントに GET リクエストを送信します。レスポンスに含まれるもの 現在の maxPoints 値。採点なしの課題が null または 0 である maxPoints の値。

Classroom に成績を戻した場合は、 取得または使用する courses.courseWork.addOnAttachments.studentSubmissions エンドポイント アドオン添付ファイルの成績を変更する。成績の値は pointsEarned フィールド。この値を確認し、必要に応じて更新することを検討してください ご使用のプロダクトで、教師が特定の生徒の できます。