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