Classroom ルーブリックに慣れていない場合は、ヘルプセンターの記事でルーブリックの一般的な構造と、Classroom UI でのルーブリック採点を行う方法を確認してください。
ルーブリックの構造
API を使用してルーブリックを操作する場合は、いくつかの重要なコンセプトを強調することをおすすめします。
- 1 つのルーブリックは(多くても 1 つ)
CourseWork
、そのルーブリックはCourseWork
そのルーブリックに固有のルーブリックであり、CourseWork
リソース間で共有することはできません。 - ルーブリックは基準で構成され、各基準はレベルで構成されています。ルーブリックには常に少なくとも 1 つの基準が必要です。また、基準には少なくとも 1 つのレベルが必要です。
- レベルには得点を付ける(得点を設定する)か、採点しない(得点しない)ことができます。ルーブリックでレベルを完全に採点するか、完全に採点対象外にする必要があります。
- レベルにスコアを付ける場合、評価基準のすべてのレベルに一意のポイント値を設定する必要があります。小数点には整数(10 など)または浮動小数点値(9.99 など)を使用できます。0 も指定できます。null 値は使用できません。また、1 つのルーブリックに 1 つの基準を 0 点とすることはできません。
- レベルにスコアを付けない場合、ポイント フィールドは省略する必要があります。null 値は使用できません。
- 基準とレベルの順序には意味があり、Classroom UI での表示順序を反映しています。
- 特に、スコアレベルは、常にポイントの昇順または降順で並べ替える必要があります。
- 各ルーブリックには最大 50 個の基準、評価基準には最大 10 個の評価レベルを設定できます。
関連する生徒の提出物フィールド
生徒の提出物オブジェクトも次のように変更されます。
- ルーブリックを使用して採点された生徒の提出物には、既存の
draftGrade
プロパティとassignedGrade
プロパティに加えて、draftRubricGrades
プロパティとassignedRubricGrades
プロパティがあります。これらは、ルーブリックからの採点、下書き、割り当て済みの状態で生徒がそれぞれ受け取るルーブリック成績(選択したレベルと点数)を表します。 - 現在、これらのプロパティは読み取り専用です。つまり、この API を使用して提出物を採点することはできませんが、Classroom の UI で採点された提出物を読むことができます。
- 生徒の提出物と関連するルーブリックには
rubricId
フィールドが含まれます。このフィールドは、CourseWork
に関連付けられている最新のルーブリックを表します。教師がルーブリックを削除してから再作成すると、この値は変更される可能性があります。
ルーブリックの動作
この API は、可能な限り一貫性を保つために Classroom の UI をミラーリングすることを目指していますが、この動作がデベロッパーにとって直感的でない可能性があるため、言及しておくべきです。
- ルーブリックは、教師を制約することなく、採点をガイドすることを目的としています。そのため、教師はルーブリックを使用して提出物を採点する際に、以下を行うことができます。
- 採点時にはルーブリックを完全に無視してください。
- 評価基準のレベルで使用可能な点に関係なく、評価基準の点をオーバーライドします。
- 条件のサブセットに対してのみレベルを選択します。
- 評価基準では、対応するレベルを選択せずに点数を割り当てます。
- ルーブリックの点数に関係なく、課題の合計点をオーバーライドします。
また、この API で新たに導入された機能もありません。つまり、この API は、Classroom UI にない動作をサポートしていません。たとえば、この API では課題にルーブリックの使用を強制したり、教師によるルーブリックや提出物の編集機能をオーバーライドしたりすることはできません。
採点中の制限事項
同様に、教師がルーブリックを使用した採点を開始した後に、ルーブリックを編集する場合にもいくつかの制限が加わります。採点が開始されたら、以下の編集のみ可能です。
- 評価基準とレベルのタイトルと説明のテキストは編集できます。
- レベルの順序は、条件内で変更される可能性があります。
追加のスコープ
ルーブリックは手動で Google スプレッドシートにエクスポートして、教師が再利用できます。
これらのスプレッドシートからルーブリックを作成または更新する場合(ガイドの例を参照)、アプリケーションは https://www.googleapis.com/auth/spreadsheets.readonly
または https://www.googleapis.com/auth/spreadsheets
のスコープをリクエストする必要があります。spreadsheets
スコープは機密とみなされ、アプリの確認が必要になる場合があります。