Mokomųjų bloknotų ir svetainių parengimas dideliu mastu naudojant "Microsoft Graph API"

"„Microsoft“" gerindama savo saugos būseną visuose produktuose ir paslaugose, neseniai atlikta API funkcijų pakeitimų , kurie gali turėti įtakos klientams, kurie anksčiau naudojosi tik programų teisėmis konfigūruoti mokomuosius bloknotus naudodami API.

Vis dar galite konfigūruoti svetaines ir bloknotus reikiamu mastu naudodami "Microsoft Graph" API, naudodami palaikomą alternatyvų metodą. Šiame straipsnyje aprašomi veiksmai ir pateikiami saitai į susijusius dokumentus.

Apžvalga

Norėdami tęsti mokomųjų bloknotų ir "SharePoint" svetainių parengimą reikiamu mastu:

  1. CreateEducationClass API naudojimas kuriant naujas svetaines (viena grupė / svetainė kiekvienai klasei)
  2. Jei jau esamos svetainės, naudokite "SharePoint CreatePermission" API , kad suteiktumėte "OneNote" mokomojo bloknoto "AppId" teises tai svetainei.
  3. Atlikus anksčiau nurodytus veiksmus, esamos mokomojo bloknoto funkcijos turėtų būti atkurtos ir API iškvietimai, pvz., "GetClassNotebooks", "AddTeacher" ir "addStudent", turėtų veikti kaip numatyta.

Nuoseklios instrukcijos

1. Kurkite naujas svetaines naudodami "CreateEducationClass"

Naudokite "CreateEducationClass " API, kad sukurtumėte naują "Microsoft 365" grupę ir susietą "SharePoint" svetainę kiekvienai klasei.

  • Ši API parengia grupę, svetainę ir susijusius išteklius vieno skambučio metu.
  • Sukūrę svetainę, galite naudoti esamas API bloknotams ir teisėms valdyti.

Nuoroda: CreateEducationClass API dokumentacija

2. Teisių suteikimas esamoms svetainėms

Esamoms grupėms ar svetainėms turite suteikti mokomojo bloknoto taikomosios programos prieigą naudodami " Sites.Selected" teisių modelį.

Būtinos teisės

  • Prieiga tik prie programų naudojant Sites.Selected aprėptį.
  • Suteikite EDU "OneNote" programai visas svetainės teises.

Pavyzdžio užklausa

POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //paskirties programos kliento ID "displayName": "EDU OneNote" //Target application's Display name } }] }

Nuorodos:

Kurti teisių API

Kurkite programas, kurios naudoja "Sites.Selected" teises SPO svetainėms

"Microsoft 365" kūrėjų tinklaraštis: Dabar "Microsoft Graph" galima valdyti programų prieigą konkrečiuose "SharePoint" svetainių rinkiniuose

3. Esamų API naudojimas bloknoto valdymui

Tinkamai sukonfigūravus teises, esamos mokomojo bloknoto funkcijos, pvz., toliau pateikiamos API, turėtų toliau veikti:

  • GetClassNotebooks

  • AddTeacher

  • AddStudent

  • CreateClassNotebook

    • Pastaba: kaip aprašyta anksčiau, naujoms grupėms / svetainėms naudokite "CreateEducationClass"