Keďže spoločnosť Microsoft vylepšuje svoju úroveň zabezpečenia vo všetkých produktoch a službách, nedávno došlo k zmenám funkcií rozhrania API, ktoré môžu mať vplyv na zákazníkov, ktorí sa predtým pri zriaďovaní poznámkových blokov pre učebné predmety pomocou rozhraní API spoliehali na povolenia len pre aplikácie.
Lokality a poznámkové bloky môžete naďalej zriaďovať vo veľkom pomocou rozhraní Microsoft Graph API pomocou podporovanej alternatívnej metódy. V tomto článku sú uvedené kroky a prepojenia na príslušnú dokumentáciu.
Prehľad
Ak chcete pokračovať v zriaďovaní poznámkových blokov pre učebné predmety a lokalít SharePoint vo veľkom rozsahu:
- Použitie rozhrania CreateEducationClass API pri vytváraní nových lokalít (jedna skupina alebo lokalita na triedu)
- V prípade už existujúcich lokalít použite rozhranie API CreatePermission pre SharePoint a udeľte licencie pre identifikácie aplikácií pre Onenotový poznámkový blok pre učebné predmety na danej lokalite.
- Po dokončení vyššie uvedených krokov by sa mali obnoviť existujúce funkcie poznámkového bloku pre učebné predmety a volania rozhrania API, ako napríklad GetClassNotebooks, AddTeacher a addStudent , by mali fungovať podľa očakávania.
Podrobné pokyny
1. Vytvorenie nových lokalít pomocou funkcie CreateEducationClass
Pomocou rozhrania CreateEducationClass API vytvorte novú skupinu v Microsoft 365 a priradenú lokalitu SharePoint pre každú triedu.
- Toto rozhranie API zriaďuje skupinu, lokalitu a priradené zdroje v jednom volaní.
- Po vytvorení lokality môžete použiť existujúce rozhrania API na spravovanie poznámkových blokov a povolení.
Referencia: Dokumentácia rozhrania API CreateEducationClass
2. Udelenie povolení existujúcim lokalitám
Existujúcim skupinám alebo lokalitám musíte aplikácii Poznámkový blok pre učebné predmety explicitne udeliť prístup pomocou modelu povolení Sites.Selected .
Požadované povolenia
- Prístup len k aplikáciám pomocou položky Sites.Selected scope.
- Lokalite udeľte úplnú kontrolu nad aplikáciou EDU OneNote.
Vzorová žiadosť
| 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 klienta cieľovej aplikácie "displayName": "EDU OneNote" //Zobrazované meno cieľovej aplikácie } }] } |
|---|
Referencie:
Vytvorenie rozhrania API povolení
Vývoj aplikácií, ktoré používajú lokality.Selected permissions for SPO sites
3. Používanie existujúcich rozhraní API na správu poznámkových blokov
Po správnej konfigurácii povolení by existujúce funkcie poznámkového bloku pre učebné predmety, ako sú napríklad nasledujúce rozhrania API, mali naďalej fungovať ako predtým:
GetClassNotebooks
Pridať učiteľa
Pridať študenta
CreateClassNotebook (VytvoriťPoznámkový blokTriedy)
- Poznámka: Ako je popísané vyššie, pre nové skupiny alebo lokality použite namiesto toho funkciu CreateEducationClass