Efterhånden som Microsoft forbedrer sit sikkerhedsniveau på tværs af alle produkter og tjenester, er der for nylig sket ændringer af API-funktionalitet, der kan påvirke kunder, der tidligere var afhængige af apptilladelser til at klargøre klassenotesbøger ved hjælp af API'er.
Du kan stadig klargøre websteder og notesbøger i stor skala ved hjælp af API'er til Microsoft Graph ved at følge en understøttet alternativ metode. I denne artikel beskrives trinnene og indeholder links til relevant dokumentation.
Oversigt
Sådan fortsætter du med at klargøre klassenotesbøger og SharePoint-websteder i stor skala:
- Brug CreateEducationClass API'en , når du opretter nye websteder (én gruppe/et websted pr. klasse)
- For eksisterende websteder skal du bruge SharePoint CreatePermission API'en til at tildele AppId-tilladelser til OneNote-klassenotesbog til det pågældende websted.
- Når trinnene ovenfor er fuldført, bør den eksisterende funktioner i Klassenotesbog gendannes, og API-kald som GetClassNotebooks, AddTeacher og addStudent bør fungere som forventet.
Trinvis vejledning
1. Opret nye websteder med CreateEducationClass
Brug CreateEducationClass-API'en til at oprette en ny Microsoft 365-gruppe og et tilknyttet SharePoint-websted for hver klasse.
- Denne API klargør gruppen, webstedet og tilknyttede ressourcer i ét kald.
- Når webstedet er oprettet, kan du bruge eksisterende API'er til at administrere notesbøger og tilladelser.
Reference: Dokumentation til CreateEducationClass API
2. Giv tilladelser til eksisterende websteder
For eksisterende grupper eller websteder skal du eksplicit give klassenotesbogappen adgang ved hjælp af tilladelsesmodellen Sites.Selected .
Påkrævede tilladelser
- Kun appadgang ved hjælp af området Sites.Selected.
- Giv EDU OneNote-appen fuld kontrol over webstedet.
Eksempel på anmodning
| 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's Client ID "displayName": "EDU OneNote" //Target Application's Display name } }] } |
|---|
Referencer:
Udvikle programmer, der bruger Sites.Selected tilladelser til SPO-websteder
3. Brug eksisterende API'er til administration af notesbøger
Når tilladelser er konfigureret korrekt, bør eksisterende funktioner i Klassenotesbog, f.eks. følgende API'er, fortsat fungere som før:
GetClassNotebooks
Tilføj lærer
TilføjStuderende
CreateClassNotebook
- Bemærk: som beskrevet ovenfor, for nye grupper/websteder, skal du bruge CreateEducationClass i stedet