Method: userProfiles.checkUserCapability

ユーザーが指定された Classroom の機能を使用できるかどうかを返します。たとえば、このエンドポイントを使用して、ユーザーがアドオンの添付ファイルを作成できるかどうかを確認できます。

リクエストを行うユーザーは、自分のケーパビリティのみを確認できます。

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

  • PERMISSION_DENIED: リクエスト元のユーザーが、指定されたユーザーの利用資格を確認することを許可されていない場合。
  • リクエストの形式が正しくない場合は INVALID_ARGUMENT。

HTTP リクエスト

GET https://classroom.googleapis.com/v1/userProfiles/{userId}:checkUserCapability

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

パスパラメータ

パラメータ
userId

string

必須。ユーザーの識別子。

リクエストのパラメータとして指定する場合、この識別子は次のいずれかになります。

  • ユーザーの数値識別子
  • ユーザーのメールアドレス
  • リクエストしているユーザーを示す文字列リテラル "me"

クエリ パラメータ

パラメータ
capability

enum (Capability)

必須。このユーザーに対して確認する Capability。たとえば、ユーザーがアドオンの添付ファイルを作成できるかどうかを確認するには、これを CREATE_ADD_ON_ATTACHMENT に設定します。
previewVersion

enum (PreviewVersion)

省略可。API のプレビュー バージョン。

リクエストの本文

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

レスポンスの本文

ユーザーの機能を確認した結果のレスポンス。

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

JSON 表現 
{
  "capability": enum (Capability),
  "allowed": boolean
}
フィールド
capability

enum (Capability)

Classroom の機能。
allowed

boolean

指定されたケーパビリティがユーザーに許可されているかどうか。

認可スコープ

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

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

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

能力

機能を表現する列挙型。

列挙型
CAPABILITY_UNSPECIFIED サポートされていません。
CREATE_ADD_ON_ATTACHMENT リクエストの作成に使用された OAuth クライアント ID の Developer Console プロジェクトに関連付けられた AddOnAttachments を作成および変更する機能。
CREATE_RUBRIC ルーブリックを作成、変更する機能。
UPDATE_GRADING_PERIOD_SETTINGS 成績期間の設定を変更する機能。
CREATE_STUDENT_GROUP 生徒グループとそのメンバーを作成および変更する機能。