Method: courses.checkGradingPeriodsSetupEligibility

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

このメソッドは非推奨です。UserProfiles.checkUserCapability を代わりに使用してください。

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

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
courseId

string

必須。コースの識別子。

クエリ パラメータ

パラメータ
previewVersion

enum (PreviewVersion)

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

リクエスト本文

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

レスポンスの本文

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

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

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

string

変更不可。コースの識別子。
isGradingPeriodsSetupEligible

boolean

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

enum (PreviewVersion)

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

認可スコープ

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

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

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