Method: courses.checkGradingPeriodsSetupEligibility

ユーザーが特定のコースで GradingPeriodSettings の更新の資格があるかどうかを返します。

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

  • PERMISSION_DENIED: アクセスエラー。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • リクエストされたコースが存在しない場合は NOT_FOUND。

HTTP リクエスト

GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility

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

パスパラメータ

パラメータ
courseId

string

必須。コースの ID。

クエリ パラメータ

パラメータ
previewVersion

enum (PreviewVersion)

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

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

ユーザーがこのコースで GradingPeriodSettings の更新を許可するかどうか。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "courseId": string,
  "isGradingPeriodsSetupEligible": boolean,
  "previewVersion": enum (PreviewVersion)
}
フィールド
courseId

string

変更不可。コースの ID。
isGradingPeriodsSetupEligible

boolean

ユーザーがこのコースで GradingPeriodSettings を更新できるかどうか。
previewVersion

enum (PreviewVersion)

出力専用。API のプレビュー版。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、設定する必要があります。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

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