Microsoft Learn Katalog API'sinde sık sorulan sorular
Bu makalede, Microsoft Learn Katalog API'siyle ilgili sık sorulan sorular ve yanıtlar ve gerektiğinde daha fazla bilgi için bağlantılar listelenir.
Genel
S: Learn Kataloğu API'sini kullanmanın maliyeti nedir?
Learn Kataloğu API'sini kullanmanın bir maliyeti yoktur. Daha fazla bilgi için, Learn Katalog API'sine genel bakış makalesininKullanılabilirlik ve Fiyatlandırma bölümüne bakın.
S: Learn Kataloğu API'sini kullanma kuralları nelerdir?
Microsoft Learn ve Microsoft API Kullanım Koşulları bakın.
S: Learn Kataloğu API'sini kullanmak için anahtarları eklemem veya edinmem gerekiyor mu?
Hayır. API genel kullanıma açıktır. cURL ve Visual Studio Code kullanarak Learn Katalog API'sini kullanmaya başlama makalesine ve/veya Learn Katalog API'si Geliştirici Referansı makalesinebakın.
S: Bu API, kullanıcılarımızın platformumuzdaki Learn içeriğini kullanmasına izin verecek mi?
Hayır. Learn Catalog API'sinde içerikle ilgili meta veriler ve içeriğe doğrudan bağlantılar sağlanır. Kullanıcılar, Microsoft API Kullanım Koşullarıgöre bu bağlantıları herhangi bir Öğrenme Yönetim Sistemi (LMS) veya web deneyimiyle tümleştirebilir.
S: Learn Kataloğu API'sinden döndürülen veriler statik mi kalıyor yoksa değişiyor mu?
Veriler her yeni içerik eklendiğinde, değiştirildiğinde veya silindiğinde değişir ve bu genellikle günlük olarak gerçekleşir.
API Yanıtı
S: Tüm verileri aynı anda alabilir miyim?
Evet. Tam yanıtı almak için temel uç nokta learn.microsoft.com/api/catalog kullanın. Daha fazla API isteği bilgisi için Learn Catalog API Geliştirici Başvurusu makalesine bakın.
S: Yanıtı önceden filtreleyebilir miyim?
Evet. Learn Katalog API'sinin Geliştirici Başvurusu makalesinde bulunan sorgu filtrelerine bakın.
S: UID'ler her içerik nesnesi için benzersiz mi?
Evet. UID, "Benzersiz Kimlik" anlamına gelir ve her içerik nesnesi için benzersizdir. Bir UID değişirse, başlık veya diğer meta veriler aynı kalsa bile içerik yeni bir nesne olarak kabul edilir.
S: Modülün özetinde neden HTML etiketleri var?
Genellikle özetin biçimlendirmesini mümkün olduğunca ham tutmaya çalışırız, ancak bazen belirli metni vurgulamamız veya bağlamamız gerekir.
S: Tek tek birimler için neden bağlantı yok?
Birimler tek başına içerik olarak yazılmıyor. Bunların modül için belirli bir sırada alınması amaçlanmıştır. Bu nedenle, kullanıcıların orada başlayıp içerikte ilerleyebilmesi için modül ayrıntı sayfasının bağlantısını ve ilk üniteyi ekleyeceğiz.
S: Hangi içeriğin yeni olduğunu nasıl anlarım?
last_modified değeri, kaydın en son ne zaman değiştirildiğini bildirir.
S: İçerik bağlantıları için Tek Sign-On (SSO) etkinleştirildi mi?
Şu anda yok. Gelecekte SSO'nun etkinleştirilmesini hedefliyoruz.
İçerik
S: UID içerik için benzersiz mi?
Evet. UID, "Benzersiz Kimlik" anlamına gelir ve her içerik nesnesi için benzersizdir. Bir UID değişirse, başlık veya diğer meta veriler aynı kalsa bile içerik yeni bir nesne olarak kabul edilir.
S: Tüm modüller öğrenme yolunun bir parçası mı?
Hayır. Modüllerin tümü, bir senaryoyu veya kavramı uçtan uca öğretmek ve önkoşul modüllerini almayı gerektirmemesi açısından tek başına durabilme özelliğine sahiptir. Bazıları için bu budur ve öğrenme yolunun bir parçası değildir. Diğerleri için, bir kullanıcıyı daha gelişmiş kavramlar oluşturmaya götüren bir veya daha fazla öğrenme yolunda birlikte paketlenmiştir. Bir modülün öğrenme yolunun parçası olması gerekmez veya bir veya daha fazla modülün parçası olabilir.
S: İçeriğin ne zaman eklendiğini, yenilendiğini veya silindiğini nasıl anbilirim?
Yeni içerik nesneleri eklendiğinde, yanıtta yeni bir nesne (UID tarafından tanımlanır) olarak görünürler. İçerik değiştirildiğinde, içeriği last_modified değerine göre anlayabilirsiniz. İçerik silindiğinde, içerik nesnesi yanıttan kaldırılır. API yanıtında içerik güncelleştirilirken bazen biraz gecikme yaşansa da, kullanıcı içeriğin URL'sini izlediğinde her zaman en güncel bilgileri görür. İçerik silindiğinde, eski URL yeni içeriğe veya deneyime veya bir sonraki en iyi seçeneğe yönlendirilir.
Özellikle, içerik sürekli güncelleştiriliyor. Kullanılabilir güncelleştirmeleri günde iki kez yayımlıyoruz. Küçük metin değişiklikleri gibi küçük veya büyük düzeltmeler, eklemeler veya silmeler gibi önemli olabilir. Genel olarak, içerik portföyü binlerce katkıda bulunana sahip büyük, yüksek oranda yönetilen bir açık kaynak proje olarak yönetilir ve bu nedenle değişiklikler her zaman yaşanıyor. Üretim sisteminizde Learn Katalog API'sini kullanıyorsanız, bunun farkında olmanız ve sisteminizin bunu işleyebilmesini sağlamanız gerekir.
Q: Yer işareti eklediğim bir bağlantıyı takip ettim, ama şimdi beklediğimden farklı bir içerik gösteriliyor. Neden?
Sitemizdeki bağlantılarda kimsenin bir çıkmaz sayfayla (404) karşılaşmadığından emin olmak için çalışıyoruz. İçerik değiştirildiğinde veya yerine yenisi konulduğunda, eskiden kalma bağlantı için sizi otomatik olarak yeni içeriğe yönlendirecek bir yeniden yönlendirme uygularız. İçeriğin kullanım dışı bırakıldığı ve çeşitli nedenlerle değiştirilmediği durumlarda, biraz değiştirilmiş bir kapsam veya giriş sayfası vb. olabilecek bir sonraki en uygun içeriğe yeniden yönlendireceğiz.
S: Belgelere, videoya ve kod örneği kataloglarına nasıl erişebilirim?
Şu anda bu kataloglara erişmek için programlı bir yol yoktur. Gelecekte bu kataloglara programlı erişim sağlamayı hedefliyoruz.
Yerelleştirme
S: Microsoft Learn'de hangi diller kullanılabilir?
Microsoft Learn'de 65'in üzerinde yerel ayar mevcuttur. Tam listeyi burada site alt bilgisi aracılığıyla görebilirsiniz (tam listeyi görmek için görüntülediğiniz dili seçin).
S: İçerik diğer dillerde kullanılabilir mi?
Buna göre değişir. İçeriği, içerikte öğretilen ürünlerin mevcut olduğu tüm dillerde kullanılabilir hale getirmeyi hedefliyoruz. Öğrenciler belirli bir yerel ayarda Microsoft Learn sitesini ziyaret ettiğinde, içerik bu yerel ayarda kullanılamıyorsa, kullanıcı üst bilgi ve alt bilgiyi istediği yerel ayarda görür ve yerelleştirilmiş bir sürüm sağlanana kadar temel içerik varsayılan olarak İngilizce olur.
S: Belirli bir içerik nesnesi için içerik, hangi dilde görüntülediğinizden farklı mı?
Belki. güncelleştirmeler İngilizce içerikte yayımlandığında, yerelleştirilmiş sürümlerin en kısa sürede güncelleştirilmesi için yerelleştirme işlem hatlarımız çalışır ( genellikle özgün değişikliği izleyen birkaç gün içinde).
Diğer
S: Görünümler, tıklamalar, tamamlama gibi verileri almak için herhangi bir raporlama API'si veya işlevi var mı?
Şu anda raporlama API'miz yok. Kuruluşların kullanıcı tamamlamalarını raporlamasına olanak tanıyan kuruluş raporlama işlevine sahibiz.
Sonraki adımlar
Katalog Öğrenin API'si hakkında daha fazla bilgi edinmek için aşağıdaki bağlantıları ziyaret edebilirsiniz: