ルーブリックの構造と既知の制限事項

Classroom のルーブリックに慣れていない場合は、ヘルプセンター記事でルーブリックの一般的な構造と、Classroom UI でルーブリックの採点を行う方法をご覧ください。

ルーブリックの構成

API を使用して評価基準を操作する際に、強調すべき重要なコンセプトがいくつかあります。

  • CourseWork に関連付けられている評価基準は（最大で）1 つだけです。その評価基準は CourseWork に固有のものであり、CourseWork リソース間で共有することはできません。
  • ルーブリックは基準で構成され、基準はレベルで構成します。ルーブリックには必ず少なくとも 1 つの基準が必要で、評価基準には少なくとも 1 つのレベルが必要です。
  • レベルは、点数ありまたは点数なしに設定できます。レベルは、評価尺度で完全に評価するか、完全に評価しないかのいずれかにする必要があります。
    • レベルにスコアを付ける場合は、基準内のすべてのレベルに一意のポイント値を設定する必要があります。ポイントには、整数（10 など）または浮動小数点値（9.99 など）を使用できます。0 が含まれる場合があります。null 値は使用できません。また、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 スコープは機密情報と見なされるため、アプリの確認が必要になる場合があります。

前へ
採点期間