Omogočanje uporabe zvezkov za predavanja in spletnih mest v prilagoditvenem merilu z API-ji za Microsoft Graph

Ker Microsoft izboljšuje svojo varnostno držo v vseh izdelkih in storitvah, so se nedavno spremenile funkcije API-ja, ki lahko vplivajo na uporabnike, ki so se prej zanašali na dovoljenja le za aplikacijo za omogočanje zvezkov za predavanje z API-ji.

Spletna mesta in zvezke lahko še vedno uporabljate v velikem merilu z API-ji Microsoft Graph tako, da upoštevate podprto alternativno metodo. V tem članku so opisani koraki in povezave do ustrezne dokumentacije.

Pregled

Če želite nastaviti omogočanje uporabe zvezkov za predavanja in SharePointovih mest v enaki prilagoditvi:

  1. Pri ustvarjanju novih spletnih mest uporabite API CreateEducationClass (ena skupina/spletno mesto na razred)
  2. Za že obstoječa mesta uporabite SharePoint CreatePermission API , s katerim dodelite dovoljenja za OneNotov zvezek za predavanja AppId za to mesto.
  3. Ko dokončate zgornje korake, obnovite obstoječe funkcije zvezka za predavanja, klici API-ja, kot so GetClassNotebooks, AddTeacher in addStudent , pa bi morali delovati po pričakovanjih.

Navodila po korakih

1. Ustvarite nova spletna mesta s funkcijo CreateEducationClass

Z API-jem CreateEducationClass lahko ustvarite novo skupino storitve Microsoft 365 in povezano SharePointovo mesto za vsak razred.

  • Ta API omogoči skupino, spletno mesto in povezane vire z enim klicem.
  • Ko je mesto ustvarjeno, lahko z obstoječimi API-ji upravljate zvezke in dovoljenja.

Vir: dokumentacija API-ja CreateEducationClass

2. Dodelitev dovoljenj obstoječim mestom

Za obstoječe skupine ali mesta morate aplikaciji zvezka za predavanja izrecno podeliti dostop z modelom dovoljenja »Mesta.Izbrano «.

Zahtevana dovoljenja

  • Dostop samo za aplikacije z obsegom »Mesta.Izbrano«.
  • Dodelite aplikaciji EDU OneNote popoln nadzor nad spletnim mestom.

Vzorčna 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 odjemalca ciljne aplikacije "displayName": "EDU OneNote" //Prikazano ime ciljne aplikacije } }] }

Viri:

Ustvarjanje API-ja dovoljenj

Razvijanje programov, ki uporabljajo mesta. Izbrana dovoljenja za spletna mesta SharePoint Online

Spletni dnevnik za razvijalce okolja Microsoft 365: nadzor dostopa do aplikacije za določene zbirke SharePointovih mest je zdaj na voljo v tehnologiji Microsoft Graph

3. Za upravljanje zvezka uporabite obstoječe API-je

Ko so dovoljenja pravilno konfigurirana, naj bi obstoječe funkcije zvezka za predavanja, kot so ti API-ji, še naprej delovale tako kot prej:

  • GetClassNotebooks

  • AddTeacher

  • AddStudent

  • Ustvarjanje zvezka za predavanja

    • Opomba: kot je opisano zgoraj, za nove skupine/spletna mesta uporabite namesto tega CreateEducationClass