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

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

ルーブリックの構造

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

  • CourseWork に関連付けられている評価基準は（最大で）1 つだけです。その評価基準は CourseWork に固有のものであり、CourseWork リソース間で共有することはできません。
  • 評価基準は基準で構成され、基準はレベルで構成されます。評価基準には常に 1 つ以上の基準が必要です。基準には常に 1 つ以上のレベルが必要です。
  • レベルは、点数ありまたは点数なしに設定できます。レベルは、評価尺度で完全に評価するか、完全に評価しないかのいずれかにする必要があります。
    • レベルにスコアを付ける場合は、基準内のすべてのレベルに一意の点数を設定する必要があります。ポイントには、整数（10 など）または浮動小数点値（9.99 など）を使用できます。0 を含めることができます。null 値は使用できません。また、1 つの評価基準に 0 ポイントのレベルを設定することはできません。
    • レベルにスコアが設定されていない場合は、ポイント フィールドを省略する必要があります。null 値は使用できません。
  • 基準とレベルの順序は意味があり、Classroom UI に表示される順序を反映しています。
    • 特に、スコアレベルは常にポイントで昇順または降順に並べ替える必要があります。
  • ルーブリックごとに最大 50 個の評価基準を作成でき、各評価基準には最大 10 個の評価レベルを作成できます。

StudentSubmission オブジェクトは、次のような評価基準関連のフィールドをサポートしています。

  • 既存の draftGrade プロパティと assignedGrade プロパティに加えて、評価シートで採点された生徒の提出物には draftRubricGrades プロパティと assignedRubricGrades プロパティがあります。これらは、ルーブリックから採点時に生徒が受け取るルーブリックの成績（選択したレベルと点数）を表します。それぞれ、下書き状態と割り当て済み状態です。
  • 現時点では、これらのプロパティは読み取り専用です。つまり、API を使用して提出物を採点することはできませんが、Classroom UI で採点された提出物を読み取ることはできます。

ルーブリックの動作

この API は、一貫性を保つために可能な限り Classroom UI をミラーリングすることを目的としていますが、これにより、デベロッパーにとって直感的でない動作が発生する可能性があります。

  • 評価尺度は、教師を制約することなく採点のガイドとして使用することを目的としています。そのため、教師は、採点時に次のことを行えます。
    • 採点時にルーブリックは無視されます。
    • 評価基準のレベルで得られる点数に関係なく、評価基準の点数をオーバーライドします。
    • 条件のサブセットのみにレベルを選択します。
    • 対応するレベルを選択せずに、基準に点数を割り当てる。
    • ルーブリックで得られる点数に関係なく、課題の合計点をオーバーライドします。

また、この API は、Classroom UI にまだない動作をサポートしていません。たとえば、この API では、課題にルーブリックを使用することを強制したり、教師がルーブリックと提出物を編集する機能をオーバーライドしたりすることはできません。

採点時の制限事項

同様に、教師がルーブリックを使用して採点を開始すると、ルーブリックの編集に追加の制限が適用されます。採点が開始された後に行える編集は次のとおりです。

  • 評価基準とレベルのタイトルと説明はテキストで編集できます。
  • レベルの順序は、条件内で変更できます。

追加のスコープ

評価基準は、教師が再利用できるように Google スプレッドシートに手動でエクスポートできます。

これらのスプレッドシートから評価基準を作成または更新する場合（ガイドの例を参照）、アプリケーションは https://www.googleapis.com/auth/spreadsheets.readonly スコープまたは https://www.googleapis.com/auth/spreadsheets スコープをリクエストする必要があります。spreadsheets スコープは機密情報とみなされるため、アプリの確認が必要になる場合があります。

サードパーティのコースワーク

評価基準は、親の CourseWork アイテムを作成した Google Cloud プロジェクトでのみ作成できます。これは Classroom API のより広範な設計パターンであり、異なるアプリケーションが自分のリソース以外のリソースに影響するのを防ぎます。

これは、Classroom アプリでユーザーが作成したリソースにも適用されます。たとえば、同じ教師がアプリを所有している場合でも、教師が Classroom UI で作成した課題の評価基準をアプリで管理することはできません。この制限がユースケースを大幅に制限する場合は、公開バグトラッカーでフィードバックを共有してください。

ライセンス要件

ユーザーが Classroom API を使用して評価尺度を作成、更新、削除できるのは、次の条件を満たしている場合のみです。

API 機能がユーザーに公開される仕組みと、Classroom API の前提条件について詳しくは、ユーザーの利用資格をご覧ください。また、開発用デモアカウントをリクエストする前に、デモアカウントについてご確認ください。

前へ
採点期間