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