対象ユーザー

すべてのデベロッパーが 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 リクエストを送信できます。