Etablera klassanteckningsböcker och webbplatser i skala med Microsoft Graph-API:er

Eftersom Microsoft förbättrar sin säkerhetsstatus för alla produkter och tjänster har det nyligen gjorts ändringar av API-funktionaliteten som kan påverka kunder som tidigare förlitade sig på appbehörigheter för att tillhandahålla klassanteckningsböcker med API:er.

Du kan fortfarande tillhandahålla webbplatser och anteckningsböcker i stor skala med 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 skala:

  1. Använda API:t CreateEducationClass när du skapar nya webbplatser (en grupp/webbplats per klass)
  2. För befintliga webbplatser använder du SharePoint CreatePermission API för att bevilja OneNote-app-id för anteckningsbok för klassen till den webbplatsen.
  3. När ovanstående steg är slutförda ska befintliga funktioner i Anteckningsbok för klassen återställas och API-anrop som GetClassNotebooks, AddTeacher och addStudent ska fungera som förväntat.

Stegvisa instruktioner

1. Skapa nya webbplatser med CreateEducationClass

Använd CreateEducationClass API 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 samtal.
  • När webbplatsen har skapats kan du använda befintliga API:er för att hantera anteckningsböcker och behörigheter.

Referens: Dokumentation för CreateEducationClass API

2. Bevilja behörigheter till befintliga webbplatser

För befintliga grupper eller webbplatser måste du uttryckligen bevilja åtkomst till appen Anteckningsbok för klassen med hjälp av behörighetsmodellen Webbplatser.Vald .

Obligatoriska behörigheter

  • Åtkomst endast för appar med Sites.Selected scope.
  • Ge EDU OneNote-appen fullständig kontroll till webbplatsen.

Exempelbegäran

PUBLICERA https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //Målprograms klient-ID "displayName": "EDU OneNote" //Målprograms visningsnamn } }] }

Referenser:

Skapa behörighets-API

Utveckla program som använder Webbplatser.Markerade behörigheter för SPO-webbplatser

Microsoft 365 Developer Blog: Kontrollera appåtkomst för specifika SharePoint-webbplatssamlingar är nu tillgängligt i Microsoft Graph

3. Använda befintliga API:er för hantering av anteckningsböcker

När behörigheterna har konfigurerats korrekt bör befintliga funktioner i Anteckningsbok för klassen, till exempel följande API:er, fortsätta att fungera som tidigare:

  • HämtaClassNotebooks

  • AddTeacher

  • AddStudent

  • CreateClassNotebook

    • Obs! Använd CreateEducationClass i stället för nya grupper/webbplatser enligt beskrivningen ovan