Method: courses.updateGradingPeriodSettings

コースの採点期間の設定を更新します。

この方法では、個々の採点期間を追加、削除、変更できます。

リクエスト元のユーザーとコース オーナーは、採点期間を変更する権限を持っている必要があります。詳細については、ライセンス要件をご覧ください。

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

  • PERMISSION_DENIED: リクエストしたユーザーがコースの採点期間の設定を変更できない場合、またはアクセス エラーの場合:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • NOT_FOUND: リクエストされたコースが存在しない場合。

HTTP リクエスト

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

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

パスパラメータ

パラメータ
courseId

string

必須。コースの識別子。

クエリ パラメータ

パラメータ
updateMask

string (FieldMask format)

GradingPeriodSettings で更新するフィールドを特定するマスク。

GradingPeriodSettings gradingPeriods リストは、更新リクエストで指定された採点期間に完全に置き換えられます。次に例を示します。

  • ID なしでリストに追加された採点期間は、追加と見なされ、リクエスト時に新しい ID が割り当てられます。
  • 現在存在するがリクエストに含まれていない採点期間は、削除と見なされます。
  • 既存の ID と変更されたデータを含む採点期間は、編集と見なされます。変更されていないデータはそのまま残ります。
  • 不明な ID を含む採点期間はエラーになります。

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

  • gradingPeriods
  • applyToExistingCoursework

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

enum (PreviewVersion)

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

  • https://www.googleapis.com/auth/classroom.courses

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