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

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 の前提条件をご覧ください。

前へ
採点期間