Klargøring af klassenotesbøger og websteder på skala ved hjælp af Microsoft Graph-API'er

Da Microsoft forbedrer sin sikkerhedsstilling på tværs af alle produkter og tjenester, har der for nylig været ændringer af API-funktionalitet, der kan påvirke kunder, der tidligere har brugt tilladelser, der kun gælder for apps, til at klargøre klassenotesbøger ved hjælp af API'er.

Du kan stadig klargøre websteder og notesbøger i skalering ved hjælp af Microsoft Graph-API'er ved at følge en understøttet alternativ metode. Denne artikel beskriver trinnene og indeholder links til relevant dokumentation.

Oversigt

Sådan fortsætter du klargøring af klassenotesbøger og SharePoint-websteder på en skala:

  1. Brug Api'en CreateEducationClass , når du opretter nye websteder (én gruppe/websted pr. klasse)
  2. For eksisterende websteder skal du bruge SharePoint CreatePermission-API'en til at tildele OneNote-klassenotesbog AppId-tilladelser til det pågældende websted.
  3. Når ovenstående trin er fuldført, skal eksisterende klassenotesbogsfunktionalitet gendannes, og API-kald som f.eks . GetClassNotebooks, AddTeacher og addStudent bør fungere som forventet.

Trinvis vejledning

1. Opret nye websteder med CreateEducationClass

Brug Api'en CreateEducationClass til at oprette en ny Microsoft 365-gruppe og et tilknyttet SharePoint-websted for hver klasse.

  • Denne API klargør gruppen, webstedet og de tilknyttede ressourcer i ét opkald.
  • Når webstedet er oprettet, kan du bruge eksisterende API'er til at administrere notesbøger og tilladelser.

Reference: CreateEducationClass API documentation

2. Giv tilladelser til eksisterende websteder

For eksisterende grupper eller websteder skal du eksplicit give appen Klassenotesbog adgang ved hjælp af tilladelsesmodellen Websteder.Valgt .

Påkrævede tilladelser

  • Adgang kun for apps ved hjælp af Sites.Selected scope.
  • Giv EDU OneNote-appen fuld kontrol til 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:

Opret tilladelses-API

Udvikl programmer, der bruger Sites.Selected-tilladelser til SPO-websteder

Microsoft 365 Developer Blog: Kontrol af appadgang på bestemte grupper af SharePoint-websteder er nu tilgængelig i Microsoft Graph

3. Brug eksisterende API'er til administration af notesbøger

Når tilladelserne er konfigureret korrekt, bør eksisterende klassenotesbog-funktionalitet som f.eks. følgende API'er fortsat fungere som før:

  • HentClassNotebooks

  • AddTeacher

  • AddStudent

  • OpretClassNotebook

    • Bemærk! Som beskrevet ovenfor skal du for nye grupper/websteder bruge CreateEducationClass i stedet