Pe măsură ce Microsoft își consolidează poziția față de securitate în toate produsele și serviciile, au apărut modificări recente ale funcționalității API, care pot afecta clienții care anterior se bazau doar pe permisiunile aplicațiilor pentru a asigura accesul la blocnotesurile școlare utilizând API-uri.
Puteți asigura în continuare accesul la site-uri și blocnotesuri la scară, utilizând API Microsoft Graph, urmând o metodă alternativă acceptată. Acest articol schițează pașii și oferă linkuri către documentația relevantă.
Prezentare generală
Pentru a continua asigurarea accesului la blocnotesuri școlare și site-uri SharePoint la scară:
- Utilizarea API-ului CreateEducationClass atunci când creați site-uri noi (un grup/un site pentru fiecare clasă)
- Pentru site-urile preexistente, utilizați API-ul CreatePermission SharePoint pentru a acorda permisiuni AppId pentru Blocnotes școlar OneNote pentru acel site.
- După ce sunt parcurși pașii de mai sus, funcționalitatea Blocnotes școlar existent ar trebui să fie restaurată, iar apelurile API, cum ar fi GetClassNotebooks, AddTeacher și addStudent , ar trebui să funcționeze așa cum vă așteptați.
Instrucțiuni pas cu pas
1. Creați site-uri noi cu CreateEducationClass
Utilizați API-ul CreateEducationClass pentru a crea un nou grup Microsoft 365 și un site SharePoint asociat pentru fiecare clasă.
- Acest API asigură accesul grupului, site-ului și resurselor asociate într-un singur apel.
- După ce este creat site-ul, puteți utiliza API-urile existente pentru a gestiona blocnotesurile și permisiunile.
Referință: Documentația API CreateEducationClass
2. Acordați permisiuni site-urilor existente
Pentru grupurile sau site-urile existente, trebuie să acordați în mod explicit acces aplicației Blocnotes școlar utilizând modelul de permisiune Sites.Selected .
Permisiuni necesare
- Acces doar pentru aplicații utilizând Sites.Domeniul selectat.
- Acordați aplicației EDU OneNote control total asupra site-ului.
Sample Request
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //ID-ul de client al aplicației țintă "displayName": "EDU OneNote" //Numele afișat al aplicației țintă } }] } |
|---|
Referințe:
Dezvoltarea aplicațiilor care utilizează site-uri.Permisiuni selectate pentru site-urile SPO
3. Utilizați API-uri existente pentru gestionarea blocnotesurilor
După ce permisiunile sunt configurate corect, funcționalitatea Blocnotes școlar existentă, cum ar fi următoarele API-uri, ar trebui să funcționeze în continuare ca înainte:
GetClassNotebooks
AddTeacher
AddStudent
CreateClassNotebook
- Notă: așa cum este descris mai sus, pentru grupurile/site-urile noi, utilizați în schimb CreateEducationClass