По мере того как корпорация Майкрософт повышает уровень безопасности во всех продуктах и службах, в последнее время в функции API внесены изменения , которые могут повлиять на клиентов, которые ранее полагались на разрешения только для приложений при подготовке записных книжек для занятий с помощью API.
Вы по-прежнему можете предоставлять сайты и записные книжки в большом масштабе с помощью API Microsoft Graph, используя поддерживаемый альтернативный метод. В этой статье описаны шаги и приводятся ссылки на соответствующую документацию.
Обзор
Чтобы продолжить подготовку записных книжек для занятий и сайтов SharePoint в масштабе:
- Использование API CreateEducationClass при создании новых сайтов (одна группа или сайт в классе)
- Для уже существующих сайтов используйте API CreatePermission SharePoint, чтобы предоставить разрешения AppId записной книжки OneNote для занятий для этого сайта.
- После выполнения описанных выше действий существующие функции записной книжки для занятий должны быть восстановлены, а вызовы API, такие как GetClassNotebooks, AddTeacher и addStudent , должны работать должным образом.
Пошаговые инструкции
1. Создание сайтов с помощью CreateEducationClass
С помощью API CreateEducationClass создайте новую группу Microsoft 365 и связанный с ней сайт SharePoint для каждого класса.
- Этот API предоставляет группу, сайт и связанные с ними ресурсы одним вызовом.
- После создания сайта можно использовать существующие API для управления записными книжками и разрешениями.
Справочник: Документация по API CreateEducationClass
2. Предоставление разрешений существующим сайтам
Для существующих групп или сайтов необходимо явным образом предоставить приложению "Записная книжка для занятий" доступ с помощью модели разрешений Sites.Basiced .
Требуемые разрешения
- Доступ только для приложений с использованием областей Sites.Selected.
- Предоставьте приложению OneNote для образовательных учреждений полный доступ к сайту.
Пример запроса
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions content-type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //Идентификатор клиента целевого приложения "displayName": "EDU OneNote" //Отображаемое имя целевого приложения } }] } |
|---|
Список литературы:
Разработка приложений, использующих сайты.Выбранные разрешения для сайтов SPO
3. Использование существующих API для управления записными книжками
После правильной настройки разрешений существующие функции записной книжки для занятий, такие как указанные ниже API, должны продолжать работать, как и раньше:
GetClassNotebooks
AddTeacher
AddStudent
CreateClassNotebook
- Примечание. Как описано выше, для новых групп и сайтов используйте CreateEducationClass