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 gegebenenfalls Links zu weiteren Informationen aufgelistet.
Allgemein
F: Wie viel kostet die Verwendung der Learn-Katalog-API?
Für die Verwendung der Learn-Katalog-API fallen keine Kosten an. Weitere Informationen finden Sie im Abschnitt „Verfügbarkeit und Preise“ des Artikels Katalog-API von Microsoft Learn.
F: Welche Regeln gelten für die Verwendung der Learn-Katalog-API?
Weitere Informationen finden Sie unter Microsoft Learn und Microsoft APIs – Nutzungsbedingungen.
F: Muss ich ein Onboarding durchführen oder Schlüssel abrufen, um die Learn-Katalog-API verwenden zu können?
Nein. Die API ist öffentlich verfügbar. Weitere Informationen finden Sie im Artikel Erste Schritte mit der Learn-Katalog-API unter Verwendung von cURL und Visual Studio Code und/oder im Artikel Entwicklerreferenz zur Learn-Katalog-API.
Frage: Können unsere Benutzer mit dieser API die Learn-Inhalte auf unserer Plattform nutzen?
Nein. In der Learn-Katalog-API sind Metadaten zum Inhalt und direkte Links zu den Inhalten verfügbar. Benutzer können diese Links gemäß den Nutzungsbedingungen der Microsoft-API in jedes Learning Management System (LMS) oder jede Web-Erfahrung integrieren.
Frage: Bleiben die von der Learn-Katalog-API zurückgegebenen Daten statisch oder verändern sie sich?
Die Daten ändern sich, wenn neue Inhalte hinzugefügt, geändert oder gelöscht werden, was in der Regel täglich passiert.
API-Antwort
F: Kann ich alle Daten gleichzeitig abrufen?
Ja. Verwenden Sie den Basisendpunkt (learn.microsoft.com/api/catalog), um die vollständige Antwort abzurufen. Weitere Informationen zur API-Anforderung finden Sie im Artikel Entwicklerreferenz zur Learn-Katalog-API.
F: Kann ich die Antwort vorab filtern?
Ja. Weitere Informationen zu den verfügbaren Abfragefiltern finden Sie im Artikel Entwicklerreferenz für die Learn-Katalog-API.
F: Sind die UIDs für jedes Inhaltsobjekt eindeutig?
Ja. Die UID steht für „Unique ID“ und ist für jedes Inhaltsobjekt eindeutig. Wenn sich eine UID ändert, wird der Inhalt als neues Objekt betrachtet, auch wenn der Titel oder andere Metadaten identisch bleiben.
Frage: Warum gibt es HTML-Tags in der Zusammenfassung des Moduls?
Wir versuchen in der Regel, dieZusammenfassung so wenig wie möglich zu formatieren. Manchmal müssen wir jedoch bestimmte Textstellen hervorheben oder verknüpfen.
Frage: Warum gibt es keine Links für die einzelnen Einheiten?
Die Einheiten werden nicht als eigenständiger Inhalt geschrieben. Sie sollen in der im Modul vorgesehenen Reihenfolge absolviert werden. Deswegen haben wir den Link auf der Moduldetailseite und in der ersten Einheit hinzugefügt. Benutzer können an dieser Stelle beginnen und dann mit den weiteren Inhalten fortfahren.
Frage: Woher weiß ich, welche Inhalte neu sind?
Der Wert last_modified teilt Ihnen mit, wann der Datensatz zuletzt geändert wurde.
F: Ist einmaliges Anmelden (SSO) für die Inhaltslinks aktiviert?
Derzeit leider nicht. Wir möchten SSO in Zukunft ermöglichen.
Inhalt
Frage: Ist die UID für Inhalte eindeutig?
Ja. Die UID steht für „Unique ID“ und ist für jedes Inhaltsobjekt eindeutig. Wenn sich eine UID ändert, wird der Inhalt als neues Objekt betrachtet, auch wenn der Titel oder andere Metadaten identisch bleiben.
Frage: Sind alle Module Teil eines Lernpfads?
Nein. Module können in dem Sinne eigenständig sein, dass sie ein Szenario oder ein Konzept komplett vermitteln und die Absolvierung von Vorgängermodulen nicht erforderlich ist. In manchen Fällen ist das alles, und die Module gehören nicht zu einem Lernpfad. In anderen Fällen sind Module zu einem Lernpfad (oder mehreren Lernpfaden) gebündelt, bei denen fortgeschrittene Konzepte vermittelt werden. Ein Modul ist nicht zwingend Teil eines Lernpfads, aber es kann in einem oder mehreren Lernpfaden vorkommen.
F: Woher weiß ich, wann Inhalte hinzugefügt, aktualisiert oder gelöscht wurden?
Wenn neue Inhaltsobjekte hinzugefügt werden, werden sie in der Antwort (anhand der UID) als neues Objekt angezeigt. Wenn Inhalte geändert werden, können Sie dies anhand des Werts „last_modified“ 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, werden 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ächstbeste Option umgeleitet.
Die Inhalte werden ständig aktualisiert. Verfügbare Updates werden zweimal täglich veröffentlicht. Dabei kann es sich entweder um geringfügige Änderungen (z. B. kleinere Änderungen am Text) oder um umfangreiche Änderungen (z. B. größere Überarbeitungen, Ergänzungen oder Löschungen) handeln. Allgemein wird das Inhaltsportfolio wie ein umfangreiches, stark reglementiertes Open-Source-Projekt mit Tausenden von Mitwirkenden verwaltet, weshalb ständig Änderungen vorgenommen werden. Wenn Sie die Learn-Katalog-API in Ihrem Produktionssystem verwenden, sollten Sie sich darüber im Klaren sein. Außerdem sollte Ihr System in der Lage sein, damit umzugehen.
F: Ich bin einem gekennzeichneten Link zu Inhalten gefolgt, aber mir wird jetzt einen anderer Inhalt als erwartet angezeigt. Warum?
Wir bemühen uns, sicherzustellen, dass niemand mit Links zu unserer Website auf eine Sackgasse (404) trifft. 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. Wenn Inhalte aus verschiedenen Gründen veraltet sind und nicht ersetzt werden, werden wir Sie zu dem nächsten am besten geeigneten Inhalt umleiten. Dieser Bereich kann ein leicht geänderter Bereich sein, oder eine Zielseite usw.
F: Wie kann ich Zugriff auf die Dokumentations-, Video- und Codebeispielkataloge erhalten?
Es gibt derzeit keine Möglichkeit, programmgesteuert auf diese Kataloge zuzugreifen. Wir möchten in Zukunft den programmgesteuerten Zugriff auf diese Kataloge ermöglichen.
Lokalisierung
F: Welche Sprachen sind in Microsoft Learn verfügbar?
In Microsoft Learn stehen über 65 Gebietsschemas zur Verfügung. Eine vollständige Liste wird hier über die Fußzeile der Website angezeigt (wählen Sie die aktuelle Sprache aus, um die vollständige Liste anzuzeigen).
Frage: Sind die Inhalte in anderen Sprachen verfügbar?
Das ist unterschiedlich. 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 dem gewünschten Gebietsschema, und der Kerninhalt wird standardmäßig auf Englisch zurückgesetzt, bis eine lokalisierte Version verfügbar ist.
F: Unterscheidet sich der Inhalt eines bestimmten Inhaltsobjekts, je nachdem, in welcher Sprache es angezeigt wird?
Gut möglich. Wenn Updates des englischsprachigen Inhalts veröffentlicht werden, arbeiten unsere Lokalisierungspipelines daran, die lokalisierten Versionen so schnell wie möglich zu aktualisieren – in der Regel innerhalb weniger Tage nach der ursprünglichen Änderung.
Andere
Frage: Gibt es eine Berichterstellungs-API oder -Funktion, mit der sich Daten zu Seitenaufrufen, Klicks und Abschlüssen abrufen lassen?
Derzeit ist keine Berichterstellungs-API verfügbar. Wir bieten jedoch Berichterstellungsfunktionen für Organisationen, mit denen Organisationen Berichte über die Abschlüsse ihrer Benutzer*innen erstellen können.
Nächste Schritte
Weitere Informationen zur Learn-Katalog-API finden Sie unter den folgenden Links: