Корпорація Майкрософт посилює рівень безпеки в усіх продуктах і службах, тому нещодавно відбулися зміни у функціональних можливостях API, які можуть вплинути на користувачів, які раніше покладалися на дозволи лише для програм, щоб підготувати блокноти для класу за допомогою API.
Сайти та блокноти можна підготувати в масштабі за допомогою інтерфейсів API Microsoft Graph, використовуючи підтримуваний альтернативний метод. У цій статті описано кроки та наведено посилання на відповідну документацію.
Огляд
Щоб продовжити підготовку блокнотів для класу та сайтів SharePoint у масштабі, виконайте такі дії.
- Використання API CreateEducationClass під час створення нових сайтів (по одній групі або сайту на клас)
- Для наявних сайтів використовуйте API CreatePermission , щоб надати цьому сайту дозволи AppId Блокнота OneNote для класу.
- Після виконання наведених вище кроків слід відновити наявні функції Блокнота для класу, а виклики API, як-от GetClassNotebooks, AddTeacher і addStudent , працюватимуть належним чином.
Покрокові інструкції
1. Створення нових сайтів за допомогою CreateEducationClass
Створіть нову групу Microsoft 365 і пов'язаний сайт SharePoint для кожного класу за допомогою API CreateEducationClass .
- Цей API створює групу, сайт і пов'язані ресурси за один виклик.
- Після створення сайту можна використовувати наявні інтерфейси API, щоб керувати блокнотами й дозволами.
Довідка: документація з інтерфейсу API CreateEducationClass
2. Надання дозволів наявним сайтам
Для наявних груп або сайтів потрібно явно надати доступ програмі "Блокнот для класу", використовуючи модель дозволів "Сайти.Вибрано ".
Необхідні дозволи
- Доступ тільки для програми з використанням області "Сайти.Вибраний".
- Надайте сайт у програмі 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 Client ID "displayName": "EDU OneNote" //Коротке ім'я цільової програми } }] } |
|---|
Список використаної літератури:
Розробка програм, що використовують сайти.Вибрані дозволи для сайтів SPO
3. Використання наявних API для керування блокнотами
Після правильного налаштування дозволів наявні функції Блокнота для класу, наприклад наведені нижче API, мають працювати як і раніше:
GetClassNotebooks (Блокноти для класу)
AddTeacher (Додати викладача)
AddStudent (Додати учня)
Створення блокнота для класу
- Примітка. Як описано вище, для нових груп/сайтів використовуйте CreateEducationClass