Klassimärkmike ja saitide ettevalmistamine mastaabis Microsoft Graphi API-de abil

Kuna Microsoft täiustab oma turbehoiakut kõigis toodetes ja teenustes, on API funktsioonides hiljuti tehtud muudatusi , mis võivad mõjutada kliente, kes on varem API-de abil klassimärkmike ettevalmistamisel tuginenud ainult rakenduseõigustele.

Microsoft Graphi API-de abil saate saite ja märkmikke siiski mastaabis ette valmistada, järgides toetatud alternatiivset meetodit. Selles artiklis kirjeldatakse juhiseid ja esitatakse lingid asjakohasele dokumentatsioonile.

Ülevaade

Klassimärkmike ja SharePointi saitide ettevalmistamise jätkamiseks mastaabis tehke järgmist.

  1. CreateEducationClass API kasutamine uute saitide loomisel (üks rühm/sait klassi kohta)
  2. Olemasolevate saitide korral kasutage SharePoint CreatePermission API-t , et anda OneNote'i klassimärkmiku AppId sellele saidile luba.
  3. Kui ülaltoodud juhised on täidetud, tuleks olemasolevad klassimärkmiku funktsioonid taastada ja API-kutsed (nt GetClassNotebooks, AddTeacher ja addStudent ) peaksid ootuspäraselt toimima.

Üksikasjalikud juhised

1. Uute saitide loomine funktsiooniga CreateEducationClass

Iga klassi jaoks uue Microsoft 365 rühma ja seostuva SharePointi saidi loomiseks kasutage API-t CreateEducationClass .

  • See API valmistab rühma, saidi ja seostuvad ressursid ette ühes kõnes.
  • Pärast saidi loomist saate märkmike ja õiguste haldamiseks kasutada olemasolevaid API-sid.

Viide: CreateEducationClass API dokumentatsioon

2. Olemasolevatele saitidele õiguste andmine

Olemasolevate rühmade või saitide jaoks peate selgesõnaliselt andma klassimärkmiku rakendusele juurdepääsu õigusemudeli Sites.Selected abil.

Nõutavad õigused

  • Rakendusepõhine juurdepääs saitide kaudu.Valitud ulatus.
  • Saate anda saidile edu OneNote'i rakenduse täielikud õigused.

Näidistaotlus

POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions – sisutüüp: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", Sihtrakenduse kliendi ID "kuvatav nimi": "EDU OneNote" //Sihtrakenduse kuvatav nimi } }] }

Viited:

Loo õiguste API

Arendage saite kasutavad rakendused.Valitud õigused SPO saitide jaoks

Microsoft 365 arendajate ajaveeb: rakendusele juurdepääsu reguleerimine kindlates SharePointi saidikogumites on nüüd saadaval Microsoft Graphis

3. Olemasolevate API-de kasutamine märkmikuhalduse jaoks

Kui õigused on õigesti konfigureeritud, peaksid olemasolevad klassimärkmiku funktsioonid (nt järgmised API-d) töötama nagu varem:

  • GetClassNotebooks

  • AddTeacher

  • AddStudent

  • CreateClassNotebook

    • Märkus. Nagu eespool kirjeldatud, kasutage uute rühmade/saitide jaoks selle asemel createEducationClassi .