すべてのデベロッパーが Google Classroom API にリクエストを送信できますが、一部の Google Classroom 機能は特定のユーザーのみが利用できます。各機能には、特定の Google Workspace for Education ライセンス タイプなど、異なる要件が設定されている場合があります。Google Workspace for Education の各ライセンス レベルの機能の詳細については、エディションの比較ページをご覧ください。
資格要件のある機能
次の Classroom API 機能は、対象となるユーザーのみが利用できます。
ユーザーの能力を判断する
Classroom API へのリクエストは、個々のユーザーに代わって行われます。したがって、資格要件を含む API リクエストを発行する前に、ユーザーに適切な機能があるかどうかを確認する必要があります。
ユーザーに特定の機能が付与されているかどうかを確認するには、checkUserCapability メソッドに API リクエストを送信します。使用する Classroom 機能に適した Capability タイプを含めます。各特徴に適切な Capability を指定します。
| ユーザーが以下に該当するかどうかを確認するには: | Capability |
|---|---|
| リクエスト元の Google Cloud プロジェクトが所有する Classroom アドオンにアクセスできる | CREATE_ADD_ON_ATTACHMENT |
| 採点期間の設定を変更できる | UPDATE_GRADING_PERIOD_SETTINGS |
| ルーブリックを作成または変更できる | CREATE_RUBRIC |
次に、レスポンスの allowed フィールドを確認します。allowed が true の場合、ユーザーは選択した Capability にアクセスできます。その後、ユーザーに代わって Capability に関連する API リクエストを送信できます。