Dodjela resursa bilježnicama za predmete i web-mjestima na razini pomoću API-ja za Microsoft Graph

Budući da Microsoft poboljšava svoje sigurnosno stanje u svim proizvodima i uslugama, nedavno je došlo do promjena funkcionalnosti API-ja koje mogu utjecati na korisnike koji su se prije oslanjali na dozvole samo za aplikaciju za dodjelu resursa Bilježnicama za predmete pomoću API-ja.

Web-mjesta i bilježnice i dalje možete masovno dodjeljivati pomoću API-ja značajke Microsoft Graph pomoću podržane alternativne metode. U ovom se članku navode koraci i navode veze na relevantnu dokumentaciju.

Pregled

Da biste nastavili dodjeljivati resurse bilježnicama za predmete i web-mjestima sustava SharePoint u velikim razmjerima:

  1. Korištenje API-ja CreateEducationClass prilikom stvaranja novih web-mjesta (jedna grupa/web-mjesto po razredu)
  2. Za postojeća web-mjesta koristite SharePoint CreatePermission API da biste dodijelili dozvole za aplikaciju Bilježnica za predmete u programu OneNote za to web-mjesto.
  3. Nakon što su dovršeni gore navedeni koraci, postojeće funkcionalnosti Bilježnice za predmet trebale bi biti vraćene, a API pozivi kao što su GetClassNotebooks, AddTeacher i addStudent trebali bi funkcionirati prema očekivanjima.

Detaljne upute

1. Stvaranje novih web-mjesta pomoću razreda CreateEducationClass

Pomoću API-ja CreateEducationClass stvorite novu grupu okruženja Microsoft 365 i pridruženo web-mjesto sustava SharePoint za svaki predmet.

  • Taj API u jednom pozivu dodjeljuje resurse grupi, web-mjestu i povezanim resursima.
  • Kada stvorite web-mjesto, možete koristiti postojeće API-je za upravljanje bilježnicama i dozvolama.

Referenca: Dokumentacija API-ja CreateEducationClass

2. Dodjela dozvola postojećim web-mjestima

Za postojeće grupe ili web-mjesta morate izričito dopustiti pristup aplikaciji Bilježnica za razred putem modela dozvola Sites.Selected .

Potrebne dozvole

  • Pristup samo aplikaciji putem opsega Sites.Selected.
  • Dodijelite aplikaciji OneNote za obrazovanje potpunu kontrolu nad web-mjestom.

Uzorak zahtjeva

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" //Zaslonsko ime ciljne aplikacije } }] }

Reference:

Stvaranje API-ja za dozvole

Razvoj aplikacija koje koriste web-mjesta.Odabrane dozvole za web-mjesta sustava SPO

Blog za razvojne inženjere za Microsoft 365: Kontrola pristupa aplikacijama na određenim zbirkama web-mjesta sustava SharePoint sada je dostupna u programu Microsoft Graph

3. Korištenje postojećih API-ja za upravljanje bilježnicom

Kada se dozvole ispravno konfiguriraju, postojeće funkcije Bilježnice za predmete, kao što su sljedeći API-ji, trebale bi nastaviti funkcionirati kao i prije:

  • GetClassNotebooks

  • AddTeacher

  • Dodavanje učenika

  • StvoriteBilježnicuZa Predmete

    • Napomena: kao što je prethodno opisano, za nove grupe/web-mjesta koristite CreateEducationClass