While any developer can make requests to the Google Classroom API, some Google Classroom features are only available to certain users. Each feature can have different requirements, such as having a certain Google Workspace for Education license type. For a detailed breakdown of features at each Google Workspace for Education license level, see the editions comparison page .
Features with eligibility requirements
The following Classroom API features are only available to eligible users:
- Creating and modifying Classroom add-on attachments.
- Modifying grading period settings .
- Creating, modifying, and deleting rubrics .
Determine user capabilities
Requests to Classroom API are made on behalf of individual users. Therefore, you should check whether a user has the appropriate capabilities before issuing API requests with eligibility requirements.
To determine whether a user has a particular capability, make an API request to
the checkUserCapability
method. Include the appropriate Capability
type
for the Classroom feature you intend to use. Specify the
appropriate Capability
for each feature:
| To see if the user... | Capability
|
|---|---|
| Can create or modify a Classroom add-on attachment associated with the Google Cloud project of the OAuth client ID used to make the request | CREATE_ADD_ON_ATTACHMENT
|
| Can modify grading period settings | UPDATE_GRADING_PERIOD_SETTINGS
|
| Can create , modify , or delete a rubric | CREATE_RUBRIC
|
Next, check the allowed
field in the response. If allowed
is true
, then
the user has access to the chosen Capability
. You can then make API requests
related the Capability
on behalf of the user.
