Da Microsoft seinen Sicherheitsstatus für alle Produkte und Dienste verbessert, gab es kürzlich Änderungen an der API-Funktionalität, die sich auf Kunden auswirken können, die sich zuvor auf Nur-App-Berechtigungen zum Bereitstellen von Kursnotebooks mithilfe von APIs verlassen haben.
Sie können Websites und Notebooks weiterhin im großen Stil mithilfe von Microsoft Graph-APIs bereitstellen, indem Sie eine unterstützte alternative Methode verwenden. In diesem Artikel werden die Schritte beschrieben und Links zu relevanter Dokumentation bereitgestellt.
Übersicht
So setzen Sie die Bereitstellung von Kursnotizbüchern und SharePoint-Websites im großen Stil fort:
- Verwenden der CreateEducationClass-API beim Erstellen neuer Websites (eine Gruppe/Website pro Klasse)
- Verwenden Sie für bereits vorhandene Websites die SharePoint CreatePermission-API , um oneNote Class Notebook AppId-Berechtigungen für diese Website zu gewähren.
- Sobald die oben genannten Schritte abgeschlossen sind, sollten die vorhandenen Funktionen des Kursnotizbuchs wiederhergestellt werden, und API-Aufrufe wie GetClassNotebooks, AddTeacher und addStudent sollten wie erwartet funktionieren.
Schritt-für-Schritt-Anleitung
1. Erstellen neuer Websites mit CreateEducationClass
Verwenden Sie die CreateEducationClass-API , um eine neue Microsoft 365-Gruppe und eine zugehörige SharePoint-Website für jede Klasse zu erstellen.
- Diese API stellt die Gruppe, die Website und die zugeordneten Ressourcen in einem Aufruf bereit.
- Nachdem die Website erstellt wurde, können Sie vorhandene APIs verwenden, um Notebooks und Berechtigungen zu verwalten.
Referenz: Dokumentation zur CreateEducationClass-API
2. Erteilen von Berechtigungen für vorhandene Websites
Für vorhandene Gruppen oder Websites müssen Sie der Klassennotizbuch-App explizit Zugriff mithilfe des Berechtigungsmodells Sites.Selected gewähren.
Erforderliche Berechtigungen
- Nur App-Zugriff mithilfe des Bereichs "Sites.Selected".
- Gewähren Sie der EDU OneNote-App Vollzugriff auf die Website.
Beispielanforderung
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", Client-ID "displayName" der //Zielanwendung: "EDU OneNote" //Anzeigename der Zielanwendung } }] } |
|---|
Referenzen:
Entwickeln von Anwendungen, die Sites.Selected-Berechtigungen für SPO-Websites verwenden
3. Verwenden vorhandener APIs für die Notebookverwaltung
Nachdem die Berechtigungen ordnungsgemäß konfiguriert wurden, sollten vorhandene Klassennotizbuchfunktionen wie die folgenden APIs weiterhin wie zuvor funktionieren:
GetClassNotebooks
AddTeacher
AddStudent
CreateClassNotebook
- Hinweis: Wie oben beschrieben, verwenden Sie für neue Gruppen/Websites stattdessen CreateEducationClass .