Method: courses.courseWork.rubrics.patch

評価尺度を更新します。

更新できるフィールドの詳細については、google.classroom.v1.Rubric をご覧ください。採点が開始されると、評価尺度の更新機能は制限されます。

リクエスト元のユーザーとコース オーナーには、採点基準の作成機能が必要です。詳細については、ライセンス要件をご覧ください。

このリクエストは、親コースの課題アイテムの作成に使用した OAuth クライアント ID の Google Cloud コンソールから行う必要があります。

このメソッドは、次のエラーコードを返します。

  • PERMISSION_DENIED: リクエスト元のデベロッパー プロジェクトが対応するコースワークを作成していない場合、ユーザーが評価尺度にリクエストされた変更を加えることが許可されていない場合、またはアクセス エラーの場合。このエラーコードは、採点がすでに開始されている場合にも返されます。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合と、次のリクエスト エラーの場合:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND: リクエストされたコース、課題、または評価基準が存在しない場合、またはユーザーが対応する課題にアクセスできない場合。
  • INTERNAL: 採点がすでに開始されている場合。

HTTP リクエスト

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
courseId

string

必須。コースの識別子。
courseWorkId

string

必須。コースの課題の識別子。
id

string

省略可。評価尺度の識別子。

クエリ パラメータ

パラメータ
updateMask

string (FieldMask format)

省略可。更新する評価尺度のフィールドを識別するマスク。このフィールドは更新を行う際に必須です。無効なフィールドが指定されている場合、更新は失敗します。評価基準の条件を定義する方法は複数あります。sourceSpreadsheetId リストと criteria リストです。一度に使用できる評価尺度は 1 つだけです。

更新リクエストで指定された評価基準によって、評価基準 criteria リストが完全に置き換えられます。たとえば、リクエストに条件またはレベルが含まれていない場合、その条件またはレベルは削除されます。新しい基準とレベルが追加され、ID が割り当てられます。既存の基準とレベルは、リクエストで ID が指定されている場合、以前に割り当てられた ID を保持します。

教師は次のフィールドを指定できます。

  • criteria
  • sourceSpreadsheetId

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
previewVersion

enum (PreviewVersion)

省略可。API のプレビュー バージョン。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、このフラグを設定する必要があります。

リクエスト本文

リクエストの本文には Rubric のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には Rubric のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/classroom.coursework.students

詳しくは、認可ガイドをご覧ください。