När Microsoft förbättrar sin säkerhetsstatus för alla produkter och tjänster har det nyligen gjorts ändringar i API-funktioner som kan påverka kunder som tidigare förlitade sig på endast app-behörigheter för att etablera klassanteckningsböcker med API:er.
Du kan fortfarande etablera webbplatser och notebook-filer i stor skala med hjälp av Microsoft Graph-API:er genom att följa en alternativ metod som stöds. Den här artikeln beskriver stegen och innehåller länkar till relevant dokumentation.
Översikt
Så här fortsätter du att etablera klassanteckningsböcker och SharePoint-webbplatser i stor skala:
- Använd CreateEducationClass-API:et när du skapar nya webbplatser (en grupp/webbplats per klass)
- För befintliga webbplatser använder du API:t SharePoint CreatePermission för att bevilja AppId-behörigheter för OneNote-anteckningsbok för klassen till webbplatsen.
- När stegen ovan har slutförts bör befintliga funktioner för Anteckningsbok för klassen återställas och API-anrop som GetClassNotebooks, AddTeacher och addStudent bör fungera som förväntat.
Stegvisa instruktioner
1. Skapa nya webbplatser med CreateEducationClass
Använd CreateEducationClass-API :et för att skapa en ny Microsoft 365-grupp och tillhörande SharePoint-webbplats för varje klass.
- Det här API:et etablerar gruppen, webbplatsen och associerade resurser i ett anrop.
- När webbplatsen har skapats kan du använda befintliga API:er för att hantera notebook-filer och behörigheter.
Referens: API-dokumentation för CreateEducationClass
2. Bevilja behörigheter till befintliga webbplatser
För befintliga grupper eller webbplatser måste du uttryckligen bevilja appen Anteckningsbok för klassen åtkomst med hjälp av behörighetsmodellen Sites.Selected .
Behörigheter som krävs
- Appåtkomst med hjälp av Sites.Selected omfång.
- Ge EDU OneNote-appen fullständig kontroll till webbplatsen.
Exempel på begäran
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", klient-ID för målprogram "displayName": "EDU OneNote" Visningsnamn för målprogram } }] } |
|---|
Referenser:
Utveckla program som använder Sites.Selected-behörigheter för SPO-webbplatser
3. Använda befintliga API:er för hantering av anteckningsböcker
När behörigheterna är korrekt konfigurerade bör befintliga funktioner i Anteckningsbok för klassen, till exempel följande API:er, fortsätta att fungera som tidigare:
GetClassNotebooks
Lägg till lärare
AddStudent
CreateClassNotebook (skapa klassanteckningsbok)
- Obs! Enligt beskrivningen ovan använder du CreateEducationClass i stället för nya grupper/webbplatser