このドキュメントでは、Classroom API に関連する採点のコンセプトについて説明します。
Google Classroom アプリでの教師の採点フローは、課題の採点と追跡の記事をご覧ください。
課題と提出物
Google Classroom で、生徒は Course の CourseWork 課題に StudentSubmissions を提出します。CourseWork は採点ありまたは採点なしにできます。CourseWork が採点されている場合、maxPoints 値が割り当てられている。これは、課題の合計点数を表します。maxPoints がゼロまたは指定されていない場合、課題は採点されません。
採点済みの課題の場合、教師はそれを生徒に返却する前に StudentSubmission で成績 draftGrade を設定します。Classroom アプリで送信が返されると、StudentSubmission に assignedGrade が自動的に設定され、現在の draftGrade と同じ値が設定されます。デベロッパーはこれらのフィールドの両方を設定できます。また、Classroom アプリの動作をエミュレートする必要があります。たとえば、draftGrade なしで assignedGrade を設定することはできません。どちらのフィールドも小数で表されます。設定されていない場合、教師が対応する成績をまだ設定していないことを意味します。成績の読み取り、設定、返却のコード例については、成績を作成して管理するをご覧ください。
生徒は同じ CourseWork 課題に複数の提出を送信できます。提出ステータスと成績履歴は StudentSubmission.submissionHistory で追跡されます。
提出期限を過ぎた課題、正当な理由がある課題、提出されていない課題
CourseWork アイテムが割り当てられると、生徒が対応する課題を操作していなくても、生徒ごとにプレースホルダ StudentSubmissions が作成されます。教師は CourseWork に dueDate を設定できます。生徒が期限までに課題を提出しなかった場合、関連する StudentSubmissions には late フィールド（true に設定）がマークされます。教師は Classroom アプリの設定で、遅延した提出を無効にすることもできます。
また、dueDate の前に提出されていない StudentSubmissions は、Classroom の採点簿に「欠落」としてアノテーションが付けられます。教師は Classroom アプリで提出物を手動で未提出としてマークすることもできます。未提出の課題には自動的に draftGrade が付与されます。これは教師がカスタマイズできますが、デフォルトでは 0 です。
未提出の課題は、教師によって [完了] または [免除] としてマークされます。
完了としてマークされた StudentSubmissions では、教師が新しいフィールドを手動で設定するまで、デフォルトの draftGrade フィールドが削除されます。免除としてマークされた StudentSubmissions は、採点期間を含む総合スコアの計算から除外されます。
教師による提出の処理方法について詳しくは、課題を採点して返却するのヘルプ記事をご覧ください。
総合成績と採点システム
Classroom では、コース内の生徒の総合成績を計算するための複数の評価システムがサポートされています。総合成績は、合計点から直接計算することも、カテゴリ別に重み付けすることも、まったく計算しないこともできます。
さまざまな採点システムとその例については、採点を設定するをご覧ください。
要点:
Courseリソースには、コースの成績設定の詳細を含むgradebookSettingsオブジェクトがあります。calculationTypeには、コースの計算方法を指定します。displaySettingsには、Classroom アプリで全体的な成績を確認できるユーザーを指定します。可能であれば、独自のアプリでこの設定を尊重することをおすすめします。たとえば、生徒が Classroom で総合成績を確認できない場合は、アプリでも表示しないでください。gradeCategoriesには、コース用に構成された評価カテゴリのリストが含まれます。これには、表示名、重み付けの割合、対応する課題のデフォルト ポイントが含まれます。
- コースで加重採点を使用している場合、カテゴリが存在しないシナリオでは、重みを正規化する必要がある場合があります。たとえば、カテゴリの重みが宿題が 20%、演習問題が 10%、クイズが 70% で、実際に演習問題がない場合、Classroom は総合成績の計算時に重みを宿題が 22%、クイズが 78% に調整します。アプリケーションで Classroom の全体的な成績をミラーリングする場合は、同じ操作を行う必要があります。
採点期間
教師は、コース内の CourseWork 課題を採点期間と呼ばれる個別の日付範囲にグループ化できます。採点期間を使用すると、採点簿ビューで課題をフィルタし、総合成績の計算用に個別のバケットを作成できます。
たとえば、教師は「春学期」と「秋学期」の採点期間を作成できます。春学期の総合成績には、春学期の日付範囲に提出期限が設定されている StudentSubmissions のみが含まれます。
コースに設定された採点システムは、採点期間にも適用されます。たとえば、上記の春と秋の採点期間が、加重採点カテゴリを使用するコースに設定されている場合、最終的に生徒の総合成績は 3 セットになります。
- コースのすべての課題の総合成績。
- 春の期間内のすべての課題の総合成績。
- 秋の期間内のすべての課題の総合成績。
いずれも、カテゴリ別の重み付けを使用して総合成績を計算します。
この機能の概要については、採点期間に関するお知らせをご覧ください。
採点期間は、課題が該当する採点期間を識別する gradingPeriodId で CourseWork を拡張します。
API を使用して採点期間を読み取ったり管理したりする方法については、採点期間の API ガイドをご覧ください。
ルーブリック
教師は Rubrics を作成して CourseWork 課題に関連付け、対応する StudentSubmissions の採点時にこれらのルーブリックを使用してガイドとして使用できます。
教師が Classroom で評価尺度を使用する方法については、評価尺度に関する記事をご覧ください。
ルーブリックは StudentSubmissions リソースを拡張し、以下のフィールドを追加します。
rubricIdは、送信された課題のCourseWorkに対応する評価基準を識別します。draftRubricGradesは、教師が送信内容を生徒に返す前に下書きした基準とプレースホルダのスコアを表します。assignedRubricGradesは、教師が提出物を返却した後に生徒が受け取る基準とスコアを表します。
API を使用してルーブリックを管理する方法や、関連する成績を確認する方法については、ルーブリック API ガイドをご覧ください。
採点スケール
Classroom では、カスタマイズ可能な採点尺度がサポートされています。たとえば、教師は数値の成績を文字の成績に変換できます。これらの設定と対応するデータは API では利用できません。