Подготовка записных книжек и сайтов для занятий в большом масштабе с помощью API Microsoft Graph

По мере того как корпорация Майкрософт повышает уровень безопасности во всех продуктах и службах, в функциональность API были внесены последние изменения , которые могут повлиять на клиентов, которые ранее использовали разрешения только для приложений для подготовки записных книжек для занятий с помощью API.

Вы по-прежнему можете подготавливать сайты и записные книжки в большом масштабе с помощью API Microsoft Graph, используя поддерживаемый альтернативный метод. В этой статье описаны шаги и приведены ссылки на соответствующую документацию.

Обзор

Чтобы продолжить подготовку записных книжек для занятий и сайтов SharePoint в большом масштабе, выполните приведенные ниже действия.

  1. Использование API CreateEducationClass при создании новых сайтов (по одной группе или сайту на класс)
  2. Для уже существующих сайтов используйте API SharePoint CreatePermission , чтобы предоставить идентификаторы AppId для занятий OneNote.
  3. После выполнения описанных выше шагов необходимо восстановить существующую функциональность записной книжки для занятий, а вызовы API, такие как GetClassNotebooks, AddTeacher и addStudent , должны работать должным образом.

Пошаговые инструкции

1. Создание новых сайтов с помощью CreateEducationClass

Используйте API CreateEducationClass , чтобы создать группу Microsoft 365 и связанный сайт SharePoint для каждого класса.

  • Этот API подготавливает ресурсы группы, сайта и связанные ресурсы в одном вызове.
  • После создания сайта можно использовать существующие API для управления записными книжками и разрешениями.

Справочник. Документация по API CreateEducationClass

2. Предоставление разрешений существующим сайтам

Для существующих групп или сайтов необходимо явно предоставить доступ к приложению "Записная книжка для занятий" с помощью модели разрешений Sites.Selected .

Необходимые разрешения

  • Доступ только для приложений с помощью Sites.Selected область.
  • Предоставьте приложению EDU 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", //Target Application's Client Id "displayName": "EDU OneNote" //Target Application's Display name } }] } }

Ссылки:

Создание API разрешений

Разработка приложений, использующих сайты.Выбранные разрешения для сайтов SPO

Блог разработчика Microsoft 365: Управление доступом приложений к определенным семействам веб-сайтов SharePoint теперь доступно в Microsoft Graph

3. Использование существующих API для управления записными книжками

После правильной настройки разрешений существующие функции записной книжки для занятий, такие как следующие API, должны продолжать работать, как и раньше:

  • GetClassNotebooks

  • AddTeacher

  • AddStudent

  • CreateClassNotebook

    • Примечание. Как описано выше, для новых групп или сайтов используйте createEducationClass .