Mivel a Microsoft az összes termékre és szolgáltatásra vonatkozóan fokozza biztonsági helyzetét, az API funkcióit érintő változások történtek, amelyek hatással lehetnek azokra az ügyfelekre, akik korábban csak alkalmazás engedélyekkel végezték ki az osztályjegyzetfüzeteket API-k segítségével.
Továbbra is kiépíthet webhelyeket és jegyzetfüzeteket nagy méretekben a Microsoft Graph API-k használatával, egy támogatott alternatív módszer követésével. Ez a cikk összefoglalja ennek lépéseit, és a vonatkozó dokumentációra mutató hivatkozásokat tartalmaz.
Áttekintés
Az Osztályjegyzetfüzetek és SharePoint-webhelyek nagy léptékű kiépítésének folytatásához:
- A CreateEducationClass API használata új webhelyek létrehozásakor (osztályonként egy csoport/webhely)
- Már meglévő webhelyek esetén a SharePoint CreatePermission API segítségével biztosítson AppId engedélyt a OneNote Osztályjegyzetfüzet alkalmazásazonosítói számára a webhely számára.
- A fenti lépések végrehajtása után vissza kell állítani az Osztályjegyzetfüzet meglévő működését, és az API-hívásoknak (például GetClassNotebooks, AddTeacher és addStudent ) a várt módon kell működniük.
Részletes utasítások
1. Új webhelyek létrehozása a CreateEducationClass segítségével
A CreateEducationClass API-val minden osztályhoz létrehozhat egy új Microsoft 365-csoportot és társított SharePoint-webhelyet.
- Ez az API egyetlen hívásban építi ki a csoportot, a helyet és a kapcsolódó erőforrásokat.
- A webhely létrehozása után meglévő API-kkal kezelheti a jegyzetfüzeteket és az engedélyeket.
Hivatkozás: A CreateEducationClass API dokumentációja
2. Engedélyek megadása meglévő webhelyekhez
A meglévő csoportok vagy webhelyek esetében explicit módon hozzáférést kell adnia az Osztályjegyzetfüzet alkalmazásnak a Sites.Selected engedélymodell használatával.
Szükséges engedélyek
- Csak alkalmazás-hozzáférés a Sites.Selected hatókör használatával.
- Adjon teljes hozzáférést az EDU OneNote alkalmazásnak a webhelyhez.
Minta kérés
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Tartalomtípus: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //a célalkalmazás ügyfélazonosítója "displayName": "EDU OneNote" //A célalkalmazás megjelenítendő neve } }] } |
|---|
Hivatkozások:
Webhelyeket használó alkalmazások fejlesztése.Kijelölt engedélyek SPO-webhelyekhez
3. Meglévő API-k használata jegyzetfüzet-kezeléshez
Az engedélyek megfelelő konfigurálását követően az Osztályjegyzetfüzet meglévő funkcióinak (például a következő API-knak) továbbra is a korábbiakhoz hasonlóan kell működniük:
GetClassNotebooks
Tanár hozzáadása
AddStudent
CreateClassNotebook
- Megjegyzés: a fent leírtaknak megfelelően új csoportokhoz/webhelyekhez használja inkább a CreateEducationClass opciót