Хотя любой разработчик может отправлять запросы к API Google Classroom, некоторые функции Google Classroom доступны только определённым пользователям. Для каждой функции могут предъявляться различные требования, например, наличие определённого типа лицензии Google Workspace for Education. Подробную информацию о функциях каждого уровня лицензии Google Workspace for Education см. на странице сравнения версий .
Особенности с требованиями к участию
Следующие функции API класса доступны только соответствующим пользователям:
- Создание и изменение дополнительных вложений Classroom .
- Изменение настроек периода оценки .
- Создание, изменение и удаление рубрик .
Определить возможности пользователя
Запросы к Classroom API выполняются от имени отдельных пользователей. Поэтому перед отправкой API-запросов с требованиями к квалификации следует проверить наличие у пользователя соответствующих прав.
Чтобы определить, есть ли у пользователя определённая возможность, отправьте API-запрос к методу checkUserCapability . Укажите соответствующий тип Capability для функции Classroom, которую вы планируете использовать. Укажите соответствующую Capability для каждой функции:
| Чтобы узнать, есть ли у пользователя... | Capability |
|---|---|
| Можно создать или изменить надстройку Classroom, связанную с проектом Google Cloud идентификатора клиента OAuth, используемого для выполнения запроса. | CREATE_ADD_ON_ATTACHMENT |
| Можно изменять настройки периода оценки | UPDATE_GRADING_PERIOD_SETTINGS |
| Может создавать , изменять или удалять рубрику | CREATE_RUBRIC |
Затем проверьте поле allowed в ответе. Если allowed равно true , то у пользователя есть доступ к выбранной Capability . После этого вы сможете отправлять запросы к API, связанные с этой Capability от имени пользователя.