Obezbeđivanje beležnica za razred i sajtova u razmeri pomoću Microsoft Graph API-ja

Kako Microsoft poboljšava položaj bezbednosti u svim proizvodima i uslugama, nedavno je došlo do promena u funkcionalnosti API-ja koje mogu da utiču na klijente koji su se ranije oslanjali na dozvole samo za aplikacije kako bi obezbedili beležnice za razred pomoću API-ja.

I dalje možete da pripremate sajtove i beležnice u velikoj meri pomoću Microsoft Graph API-ja tako što ćete pratiti podržani alternativni metod. Ovaj članak opisuje korake i obezbeđuje veze ka relevantnoj dokumentaciji.

Pregled

Da biste nastavili da obezbeđujete beležnice za razred i SharePoint lokacije u razmeri:

  1. Koristite CreateEducationClass API prilikom kreiranja novih sajtova (jedna grupa/sajt po klasi)
  2. Za već postojeće lokacije koristite SharePoint CreatePermission API da biste aplikaciji OneNote beležnica za razred dodelili dozvole za pristup toj lokaciji.
  3. Kada se gore navedeni koraci dovrše, postojeća funkcionalnost beležnice za razred treba da se vrati u prethodno stanje, a API pozivi kao što su GetClassNotebooks, AddTeacher i addStudent treba da funkcionišu kao što je očekivano.

Postupna uputstva

1. Kreirajte nove sajtove pomoću CreateEducationClass

Koristite CreateEducationClass API da biste kreirali novu Microsoft 365 grupu i povezani SharePoint sajt za svaki razred.

  • Ovaj API priprema grupu, sajt i povezane resurse u jednom pozivu.
  • Kada se napravi sajt, možete da koristite postojeće API-je da biste upravljali beležnicama i dozvolama.

Referenca: CreateEducationClass dokumentacija za API

2. Dodela dozvola postojećim sajtovima

Za postojeće grupe ili lokacije morate izričito da dodelite pristup aplikaciji "Beležnica za razred" pomoću modela dozvola "Lokacije.Izabrano ".

Potrebne dozvole

  • Pristup samo za aplikacije pomoću opsega Sites.Selected.
  • Dodelite EDU OneNote aplikaciji punu kontrolu nad sajtom.

Uzorak zahteva

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 klijenta ciljne aplikacije "displayName": "EDU OneNote" //Ime za prikaz ciljne aplikacije } }] }

Reference:

Kreiranje API-ja dozvola

Razvijanje aplikacija koje koriste Lokacije.Izabrane dozvole za SPO lokacije

Microsoft 365 blog za projektante: Kontrola pristupa aplikaciji na određenim SharePoint kolekcijama sajtova sada je dostupna u programu Microsoft Graph

3. Korišćenje postojećih API-ja za upravljanje beležnicama

Kada se dozvole ispravno konfigurišu, postojeće funkcionalnosti beležnice za razred, kao što su sledeći API-ji, trebalo bi da nastave da funkcionišu kao pre:

  • GetClassNotebooks

  • Dodavanje nastavnika

  • AddStudent

  • CreateClassNotebook

    • Napomena: Kao što je opisano iznad, za nove grupe/sajtove koristite CreateEducationClass