Klases piezīmju grāmatiņu un vietņu nodrošināšana lielā mērogā, izmantojot Microsoft Graph API

Tā kā Microsoft uzlabo drošības stāvokli visos produktos un pakalpojumos, no 2025. gada marta tika ieviestas izmaiņas API funkcionalitātē, kas var ietekmēt klientus, kuri iepriekš paļāvās uz tikai programmu atļaujām, lai nodrošinātu klases piezīmju grāmatiņas, izmantojot API.

Jūs joprojām varat nodrošināt vietnes un piezīmju grāmatiņas plašā mērogā, izmantojot Microsoft Graph API, izmantojot atbalstītu alternatīvu metodi. Šajā rakstā ir aprakstītas darbības un sniegtas saites uz atbilstošo dokumentāciju.

Pārskats

Lai turpinātu klases piezīmju grāmatiņu un SharePoint vietņu nodrošināšanu plašā mērogā:

  1. Izmantojiet CreateEducationClass API, veidojot jaunas vietnes (viena grupa/vietne katrai klasei)
  2. Iepriekš pastāvošām vietnēm izmantojiet SharePoint CreatePermission API , lai piešķirtu OneNote klases piezīmju grāmatiņas AppId atļaujas šai vietnei.
  3. Kad iepriekš norādītās darbības ir paveiktas, jāatjauno esošā klases piezīmju grāmatiņas funkcionalitāte un OneNote klases piezīmju grāmatiņas API izsaukumi, piemēram, GetClassNotebooks, AddTeacher un addStudent , darbosies, kā paredzēts. Šie zvani ir daļa no OneNote klases piezīmju grāmatiņas API, nevis Microsoft Graph.

Detalizēti norādījumi

1. Jaunu vietņu izveide, izmantojot CreateEducationClass

Izmantojiet CreateEducationClass API, lai izveidotu jaunu Microsoft 365 grupu un saistīto SharePoint vietni katrai klasei.

  • Šis API nodrošina grupu, vietni un saistītos resursus vienā izsaukumā.
  • Kad vietne ir izveidota, varat izmantot esošos API, lai pārvaldītu piezīmju grāmatiņas un atļaujas.

Atsauce: CreateEducationClass API dokumentācija

2. Atļauju piešķiršana esošajām vietnēm

Esošām grupām vai vietnēm klases piezīmju grāmatiņas programmai ir tieši jāpiešķir piekļuve, izmantojot atļauju modeli Sites.Selected .

Nepieciešamās atļaujas

  • Piekļuve tikai lietojumprogrammām, izmantojot tvērumu Sites.Selected.
  • Piešķiriet EDU OneNote programmai pilnu kontroli vietnē.

Pieprasījuma paraugs

POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //mērķa lietojumprogrammas klienta id "displayName": "EDU OneNote" //mērķa lietojumprogrammas parādāmais vārds } }] }

Atsauces:

Atļauju API izveide

Tādu lietojumprogrammu izstrāde, kuras izmanto Sites.Selected atļaujas SPO vietnēm

Microsoft 365 izstrādātāju emuārs: Programmu piekļuves kontrolēšana noteiktām SharePoint vietņu kolekcijām tagad ir pieejama programmā Microsoft Graph

3. Esošo API izmantošana piezīmju grāmatiņu pārvaldībai

Kad atļaujas ir pareizi konfigurētas, esošajai klases piezīmju grāmatiņas funkcionalitātei, piemēram, tālāk norādītajiem OneNote klases piezīmju grāmatiņas API izsaukumiem, ir jāturpina darboties kā iepriekš:

  • GetClassNotebooks

  • AddTeacher

  • AddStudent

  • CreateClassNotebook

    • Piezīme. Kā aprakstīts iepriekš, jaunām grupām/vietnēm tā vietā izmantojiet CreateEducationClass