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