Häufig gestellte Fragen zur Microsoft Learn-Katalog-API
In diesem Artikel werden häufig gestellte Fragen zur Microsoft Learn-Katalog-API mit ihren Antworten und Links zu weiteren Informationen nach Bedarf aufgeführt.
Allgemein
F: Wie viel kostet die Verwendung der Learn Catalog-API?
Es gibt keine Kosten für die Verwendung der Learn Catalog-API. Weitere Informationen finden Sie im Abschnitt „Verfügbarkeit und Preise“ des Artikels „Learn Catalog API feature overview“.
F: Welche Regeln gelten für die Verwendung der Learn Catalog-API?
Siehe Microsoft Learn und Microsoft API-Nutzungsbedingungen.
F: Muss ich Schlüssel integrieren oder abrufen, um die Learn Catalog-API zu verwenden?
Nein. Die API ist öffentlich verfügbar. Lesen Sie den Artikel zu den ersten Schritten mit der Learn Catalog API unter Verwendung von cURL und Visual Studio Code und/oder den Artikel Learn Catalog API Developer Reference.
F: Ermöglicht diese Schnittstelle unseren Benutzern, die Learn-Inhalte innerhalb unserer Plattform abzurufen?
Nein. Die Learn Catalog-API stellt Metadaten über den Inhalt und direkte Links zu den Inhalten bereit. Benutzer können diese Links gemäß den Nutzungsbedingungen der Microsoft-APIin ein beliebiges Learning Management System (LMS) oder web experience integrieren.
F: Bleiben die von der Learn Catalog-API zurückgegebenen Daten statisch oder ändern sie sich?
Die Daten werden immer dann geändert, wenn neue Inhalte hinzugefügt, geändert oder gelöscht werden, was in der Regel täglich erfolgt.
API-Antwort
F: Kann ich alle Daten gleichzeitig abrufen?
Ja. Verwenden Sie den Basisendpunkt, learn.microsoft.com/api/catalog, um die vollständige Antwort zu erhalten. Weitere API-Anforderungsinformationen finden Sie im Artikel Learn Catalog API Developer Reference.
F: Kann ich die Antwort vorab filtern?
Ja. Lesen Sie in dem Artikel derLearn Catalog API Developer Reference, welche Abfragefilter verfügbar sind.
F: Sind die UIDs für jedes Inhaltsobjekt eindeutig?
Ja. UID steht für "Unique ID" und ist für jedes Inhaltsobjekt eindeutig. Wenn eine UID geändert wird, auch wenn der Titel oder andere Metadaten gleich bleiben, wird der Inhalt als neues Objekt betrachtet.
F: Warum gibt es HTML-Tags in der Zusammenfassung des Moduls?
In der Regel versuchen wir, die Formatierung der Zusammenfassung so unformatieren wie möglich beizubehalten, aber manchmal müssen wir bestimmten Text hervorheben oder verknüpfen.
F: Warum gibt es keine Verknüpfungen für die einzelnen Einheiten?
Die Einheiten werden nicht als eigenständiger Inhalt geschrieben. Sie sollen in einer bestimmten Reihenfolge für das Modul eingenommen werden. Aus diesem Grund fügen wir den Link zur Moduldetailseite und die erste Einheit ein, damit Benutzer dort beginnen und den Inhalt durchlaufen können.
F: Wie kann ich feststellen, welche Inhalte neu sind?
Der wert last_modified teilt Ihnen mit, wann der Datensatz zuletzt geändert wurde.
F: Ist Single Sign-On (SSO) für die Inhaltslinks aktiviert?
Zurzeit nicht. Wir wollen SSO in Zukunft ermöglichen.
Inhalt
F: Ist die UID für Inhalte eindeutig?
Ja. UID steht für "Unique ID" und ist für jedes Inhaltsobjekt eindeutig. Wenn eine UID geändert wird, auch wenn der Titel oder andere Metadaten gleich bleiben, wird der Inhalt als neues Objekt betrachtet.
F: Sind alle Module Teil eines Lernpfads?
Nein. Alle Module sind in der Lage, unabhängig zu funktionieren, insofern sie ein Szenario oder Konzept durchgängig umfassen und keine vorausgehenden Module erfordern. Für einige ist dies der Fall, und sie sind nicht Teil eines Lernpfads. Für andere werden sie in einem oder mehreren Lernpfaden gebündelt, die einen Benutzer durch die Erstellung komplexerer Konzepte führen. Ein Modul muss nicht Teil eines Lernpfads sein, oder es kann Teil eines oder mehrerer sein.
F: Wie kann ich feststellen, wann Inhalte hinzugefügt, aktualisiert oder gelöscht wurden?
Wenn neue Inhaltsobjekte hinzugefügt werden, werden sie als neues Objekt (durch UID identifiziert) in der Antwort angezeigt. Wenn Inhalte geändert werden, können Sie anhand des last_modified Werts feststellen. Wenn Inhalte gelöscht werden, wird das Inhaltsobjekt aus der Antwort entfernt. Obwohl es manchmal eine leichte Verzögerung bei der Aktualisierung von Inhalten in der API-Antwort gibt, wird beim Folgen der URL zu den Inhalten immer die aktuellsten Informationen angezeigt. Wenn Inhalte gelöscht werden, wird die alte URL an den neuen Inhalt oder die neue Oberfläche oder an die nächste beste Option umgeleitet.
Insbesondere werden Inhalte ständig aktualisiert. Wir veröffentlichen verfügbare Updates zweimal täglich. Sie können entweder geringfügig sein, z. B. geringfügige Textänderungen, oder wesentlich, z. B. wesentliche Überarbeitungen, Ergänzungen oder Löschungen. Im Allgemeinen wird das Inhaltsportfolio als massives, stark reguliertes Open-Source-Projekt mit Tausenden von Mitwirkenden verwaltet, und als solche werden Änderungen ständig ausgeführt. Wenn Sie die Learn Catalog-API in Ihrem Produktionssystem verwenden, sollten Sie dies beachten und ihr System in der Lage sein, sie zu verarbeiten.
Frage: Ich folgte einem Lesezeichen-Link zu einem Inhalt, doch jetzt wird mir ein anderer Inhalt angezeigt als ich erwartet habe. Warum?
Wir bemühen uns sicherzustellen, dass niemand auf eine Sackgasse (404) stößt, wenn er Links zu unserer Website verwendet. Wenn Inhalte geändert oder ersetzt werden, implementieren wir eine Umleitung für den alten Link, der Sie automatisch zu dem neuen Inhalt führt. Falls Inhalte aus verschiedenen Gründen veraltet und nicht ersetzt werden, leiten wir auf den nächstbesten passenden Inhalt um, der inhaltlich leicht verändert sein könnte, oder auf eine Zielseite usw.
F: Wie erhalte ich Zugriff auf die Dokumentations-, Video- und Codebeispielkataloge?
Derzeit gibt es keine programmgesteuerte Möglichkeit, zugriff auf diese Kataloge zu erhalten. Wir wollen künftig den programmgesteuerten Zugriff auf diese Kataloge ermöglichen.
Lokalisierung
F: Welche Sprachen sind in Microsoft Learn verfügbar?
In Microsoft Learn sind mehr als 65 Gebietsschemas verfügbar. Sie können hier eine vollständige Liste über die Websitefußzeile anzeigen (wählen Sie die Sprache aus, die Sie anzeigen, um die vollständige Liste anzuzeigen).
F: Ist der Inhalt in anderen Sprachen verfügbar?
Es hängt davon ab. Wir wollen die Inhalte in allen Sprachen zur Verfügung stellen, in denen die in den Inhalten unterrichteten Produkte verfügbar sind. Wenn Lernende die Microsoft Learn-Website in einem bestimmten Gebietsschema besuchen, wenn der Inhalt in diesem Gebietsschema nicht verfügbar ist, sieht der Benutzer die Kopf- und Fußzeile in ihrem gewünschten Gebietsschema, und der Kerninhalt wird standardmäßig auf Englisch zurückgestellt, bis eine lokalisierte Version verfügbar ist.
F: Unterscheidet sich der Inhalt für ein bestimmtes Inhaltsobjekt, je nachdem, in welcher Sprache Sie es anzeigen?
Möglicherweise. Wenn Updates für den englischen Inhalt veröffentlicht werden, arbeiten unsere Lokalisierungspipelinen daran, die lokalisierten Versionen so schnell wie möglich zu aktualisieren – in der Regel innerhalb weniger Tage nach der ursprünglichen Änderung.
Andere
F: Gibt es eine Berichts-API oder Funktionalität zum Abrufen von Daten wie Ansichten, Klicks, Abschluss?
Zurzeit verfügen wir nicht über eine Berichts-API. Wir verfügen über Berichtsfunktionen für Organisationen, die es Organisationen ermöglichen, über die Abschlüsse ihrer Benutzer zu berichten.
Nächste Schritte
Weitere Informationen zur Learn Catalog-API finden Sie unter den folgenden Links: