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