A Microsoft Learn Catalog API gyakori kérdések
Ez a cikk a Microsoft Learn Catalog API-val kapcsolatos gyakori kérdéseket sorolja fel, és szükség szerint további információkra mutató válaszokat és hivatkozásokat tartalmaz.
Általános
K: Mennyibe kerül a Learn Catalog API használata?
A Learn Catalog API használata nem jár költséggel. További információkért tekintse meg a Learn Catalog API szolgáltatását áttekintő cikk Rendelkezésre állás és díjszabás című szakaszát.
K: Mik a Learn Catalog API használatának szabályai?
Tekintse meg a Microsoft Learn és a Microsoft API használati feltételeit.
K: Kell-e előkészítenem vagy lekérnem a kulcsokat a Learn Catalog API használatához?
Szám Az API nyilvánosan elérhető. Tekintse meg a Learn Catalog API használatának első lépéseit a cURL és a Visual Studio Code használatával, valamint/vagy a Learn Catalog API fejlesztői referenciacikkét.
K: Ez az API lehetővé teszi a felhasználóink számára a Learn-tartalmak használatát a platformon belül?
Szám A Learn Catalog API metaadatokat biztosít a tartalomról és a tartalomra mutató közvetlen hivatkozásokat. A felhasználók a Microsoft API használati feltételeinek megfelelően bármilyen Tanulás felügyeleti rendszerbe (LMS) vagy webes felületbe integrálhatják ezeket a hivatkozásokat.
K: A Learn Catalog API-ból visszaadott adatok statikusak vagy módosulnak?
Az adatok megváltoznak, amikor új tartalmat adnak hozzá, módosítanak vagy törölnek, ami általában napi rendszerességgel történik.
API-válasz
K: Egyszerre ragadhatom meg az összes adatot?
Igen. Használja az alapvégpontot, learn.microsoft.com/api/catalog a teljes válasz lekéréséhez. Az API-kéréssel kapcsolatos további információkért tekintse meg a Learn Catalog API fejlesztői referenciacikkét .
K: Előre szűrhetem a választ?
Igen. Tekintse meg a Learn Catalog API fejlesztői referenciacikkében elérhető lekérdezésszűrőket.
K: Egyediek a felhasználói felületek az egyes tartalomobjektumok esetében?
Igen. Az UID az "Egyedi azonosító" nevet jelenti, és minden egyes tartalomobjektum esetében egyedi. Ha egy UID megváltozik, még akkor is, ha a cím vagy más metaadatok változatlanok maradnak, a tartalom új objektumnak minősül.
K: Miért vannak HTML-címkék a modul összegzésében?
Általában megpróbáljuk a lehető nyersen tartani az összefoglalás formázását, de néha ki kell emelnünk vagy összekapcsolnunk kell bizonyos szövegeket.
K: Miért nincsenek hivatkozások az egyes egységekhez?
Az egységek nem önálló tartalomként lesznek megírva. Ezeket a modulhoz meghatározott sorrendben kell megadni. Ezért a modul részletes lapjára és az első egységre mutató hivatkozást is mellékeljük, hogy a felhasználók ott kezdjenek, és végighaladjanak a tartalomon.
K: Hogyan mondja el, mi az új tartalom?
A last_modified érték jelzi, hogy mikor módosították utoljára a rekordot.
K: Engedélyezve van az egyszeri bejelentkezés (SSO) a tartalomhivatkozásokhoz?
Jelenleg nem. Célunk, hogy a jövőben engedélyezzük az egyszeri bejelentkezést.
Tartalom
K: Egyedi a felhasználói azonosító a tartalomhoz?
Igen. Az UID az "Egyedi azonosító" nevet jelenti, és minden egyes tartalomobjektum esetében egyedi. Ha egy UID megváltozik, még akkor is, ha a cím vagy más metaadatok változatlanok maradnak, a tartalom új objektumnak minősül.
K: Minden modul egy képzési terv része?
Szám A modulok mind képesek önállóan állni, abban az értelemben, hogy egy forgatókönyvet vagy koncepciót tanítanak bennük, és nem igényelnek előfeltételmodulokat. Egyesek számára ez az, és nem részei a képzési tervnek. Mások számára egy vagy több képzési tervben vannak összecsomagolva, amelyek a felhasználót speciálisabb fogalmak kialakításán keresztül vezetik. Egy modulnak nem kell egy képzési terv részét képeznie, vagy egy vagy több része is lehet.
K: Hogyan tudja, hogy mikor lett hozzáadva, frissítve vagy törölve a tartalom?
Új tartalomobjektumok hozzáadásakor a válaszban új (UID által azonosított) objektumként jelennek meg. A tartalom módosításakor a last_modified értéke alapján állapíthatja meg. A tartalom törlésekor a rendszer eltávolítja a tartalomobjektumot a válaszból. Bár az API-válaszban néha némi késés tapasztalható a tartalom frissítésével kapcsolatban, amikor egy felhasználó követi a tartalom URL-címét, mindig a legfrissebb információkat látja. A tartalom törlésekor a régi URL-cím át lesz irányítva az új tartalomra vagy felületre, vagy a következő legjobb megoldásra.
A tartalom folyamatosan frissül. Naponta kétszer tesszük közzé az elérhető frissítéseket. Lehetnek kisebbek, például kisebb szövegmódosítások vagy főverziók, például főverziók, kiegészítések vagy törlések. Általánosságban elmondható, hogy a tartalomportfólió egy hatalmas, szigorúan szabályozott nyílt forráskódú projekt, több ezer közreműködővel, és mint ilyen, folyamatosan változnak. Ha a Learn Catalog API-t használja az éles rendszerben, tisztában kell lennie ezzel, és rendelkeznie kell azzal, hogy a rendszer képes kezelni.
K: Követtem egy könyvjelzővel rendelkező hivatkozást a tartalomra, de most egy másik tartalom jelenik meg, mint amire számítottam. Miért?
Arra törekszünk, hogy senki ne találjon zsákutcát (404) a webhelyre mutató hivatkozásokkal. A tartalom módosításakor vagy cseréjekor egy átirányítást vezetünk be a régi hivatkozáshoz, amely automatikusan az új tartalomra viszi. Abban az esetben, ha a tartalom elavult, és nem cserélődik le különböző okokból, átirányítjuk a következő legjobban megfelelő tartalomra, amely lehet egy kissé módosított hatókör, vagy egy kezdőlap stb.
K: Hogyan hozzáférést kap a dokumentációhoz, videóhoz és kódminta-katalógusokhoz?
Jelenleg nem lehet programozott módon hozzáférni ezekhez a katalógusokhoz. Célunk, hogy a jövőben programozott hozzáférést biztosítsunk ezekhez a katalógusokhoz.
Honosítás
K: Milyen nyelvek érhetők el a Microsoft Learnben?
A Microsoft Learnben több mint 65 területi beállítás érhető el. Itt megtekintheti a teljes listát a webhely láblécén keresztül (válassza ki a megtekintett nyelvet a teljes lista megtekintéséhez).
K: A tartalom más nyelveken is elérhető?
Ez a konkrét licenctől függ. Célunk, hogy a tartalom elérhető legyen az összes olyan nyelven, amelyen a tartalomban tanított termékek elérhetők. Amikor a tanulók meglátogatják a Microsoft Learn webhelyet egy adott területi beállításban, ha a tartalom nem érhető el az adott területi beállításban, a felhasználó a kívánt területi beállításban látja az élőfejet és az élőlábat, az alapvető tartalom pedig alapértelmezés szerint angolra kerül, amíg el nem érhető egy honosított verzió.
K: Egy adott tartalomobjektum tartalma eltér attól függően, hogy milyen nyelven tekinti meg?
Esetleg. Amikor frissítéseket tesznek közzé az angol tartalomban, a honosítási folyamataink azon dolgoznak, hogy a honosított verziókat a lehető leghamarabb frissítsük – általában az eredeti módosítást követő néhány napon belül.
Egyéb
K: Rendelkezik jelentéskészítési API-val vagy funkcióval olyan adatok lekéréséhez, mint a nézetek, a kattintások és a befejezés?
Jelenleg nem rendelkezünk jelentéskészítési API-val. Rendelkezünk szervezeti jelentéskészítési funkcióval, amely lehetővé teszi a szervezetek számára, hogy jelentést tegyenek a felhasználóik befejezéséről.
Következő lépések
A Learn Catalog API-ról az alábbi hivatkozásokra kattintva tudhat meg többet: