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

詳細については、承認ガイドをご覧ください。