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

Classroom ルーブリックについて詳しくは、ヘルプセンター記事で ルーブリックの一般的な構造と Classroom UI でのルーブリックを使用した採点方法をご確認ください。

ルーブリックの構造

API を使用してルーブリックを操作する際に注意すべき重要なコンセプトがいくつかあります。

  • CourseWork に関連付けられる ルーブリック は 1 つ（最大）で、 そのルーブリックは CourseWork に固有です（ CourseWork リソース間で共有することはできません）。
  • ルーブリックは、レベルで構成される評価基準で構成されます。ルーブリックには常に 1 つ以上の評価基準が必要で、評価基準には常に 1 つ以上のレベルが必要です。
  • レベルには、採点あり（点数あり）と採点なし（点数なし）があります。ルーブリック内のレベルは、すべて採点ありか、すべて採点なしにする必要があります。
    • レベルが採点ありの場合、評価基準内のすべてのレベルに一意の点数を設定する必要があります。点数には、整数（10 など）または浮動小数点値（9.99 など）を使用できます。0 も使用できます。null 値は使用できません。 また、ルーブリックに、1 つのレベルが 0 点の評価基準を 1 つだけ含めることはできません。
    • レベルが採点なしの場合、点数フィールドは省略する必要があります。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 の前提条件をご覧ください。

前へ
採点期間