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

Classroom のルーブリックについて詳しくは、ルーブリックの一般的な構造と Classroom UI でルーブリックを使用して評価する方法に関するヘルプセンター記事をご覧ください。

ルーブリックの構造

API を使用してルーブリックを操作する際に、強調しておくとよい重要なコンセプトがいくつかあります。

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

前へ
採点期間