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