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

必須。コースの ID。

クエリ パラメータ

パラメータ
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

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