-
Deine Kontoeinstellungen konfigurieren und anpassen
Artikel lesenIm Abschnitt Einstellungen deines Udemy Business-Kontos kannst du die Darstellung deines Kontos anpassen, Zugriffsfunktionen aktivieren und Integrationsoptionen wie SSO (Single Sign-On) und das Teilen über Slack konfigurieren. Die Einstellungen rufst du über Verwalten > Einstellungen auf.
In den Einstellungen kannst du:
- Die Darstellung deines Kontos individuell anpassen: Logo, Symbol, Hintergrund
- Deinen Nutzern anhand einer genehmigten E-Mail-Domain eigenständigen Zugriff ermöglichen
- SSO (Single Sign-On)-Zugriff über deinen Identitätsanbieter aktivieren
- SCIM-Bereitstellung zur Automatisierung der Nutzer- und Gruppenverwaltung verwenden
- Auf unsere Kurs- und Berichts-APIs und die zugehörige Dokumentation zugreifen
- Integration mit Slack oder Workplace aktivieren, um Social-Learning zu unterstützen
- Meldungen und Kontaktinformationen individuell anpassen, die Nutzern angezeigt werden, denen der Zugriff verweigert wird
Deine Domain ändern
Du kannst deine Domain (d. h. [unternehmen].udemy.com) in deinen Kontoeinstellungen zwar sehen, kannst sie aber nicht ändern.
- Wenn du ein Enterprise-Abo-Konto hast und deine Domain ändern lassen möchtest, dann kontaktiere bitte deinen Customer-Success-Partner.
- Wenn du ein Team-Abo-Konto hast, kontaktiere dafür bitte unseren Udemy Business-Support. Gib dabei bitte die neue Domain an, die du für dein Unternehmen verwenden möchtest.
-
Mein Konto anpassen
Artikel lesenDu kannst die Darstellung deines Kontos individuell anpassen, indem du drei Bilder hochlädst: ein Logo, ein Hintergrundbild und ein Unternehmenssymbol. Gehe zu Verwalten > Einstellungen > Darstellung anpassen.
- Logo: Lade ein Logo im JPG-, JPEG-, GIF-, PNG- oder BMP-Format hoch. Das Logo sollte mindestens 400 x 70 Pixel groß sein.
- Hintergrundbild: Lade ein Hintergrundbild für deine Anmeldeseite hoch. Dieses sollte mindestens 1920 x 1080 Pixel groß sein.
- Symbol: Ein optionales quadratisches Logo, das als Browser-Symbol (Favicon) verwendet werden kann. Es sollte mindestens 32 x 32 Pixel groß sein.
-
Power BI zum Abrufen von Daten über die Udemy Business-API einrichten
Artikel lesenIn diesem Artikel wird erklärt, wie Administratoren Power BI so einrichten, dass sie auf die Udemy Business-API zugreifen und die gewünschten Daten zur Berichtserstellung abrufen können.
- Hier findest du unseren Leitfaden zu den Udemy Business-APIs.
- Hier findest du Infos zur Referenz für die Udemy Business-API.
Power BI für den Zugriff auf die Udemy Business-API einrichten
- Melde dich mit Administratorrechten bei der Domain deines Unternehmens an. Die URL deines Unternehmens sollte etwa wie folgt aussehen: https://deinedomain.udemy.com/organization/home/
- Aktiviere die API auf der API-Integrationsseite (Beispiel: https://deinedomain.udemy.com/organization-manage/settings/api-integration/).
- Wähle den Button Einrichtung beginnen und wähle dann Sonstiges (Beispiel: https://deinedomain.udemy.com/organization-manage/settings/lms-integration/), gib z. B. „Power BI“ ein und wähle dann „Speichern“. Dadurch werden eine Client-ID und ein Client-Passwort generiert.
- Gehe zurück zu API > Berichts-API und wähle eine Methode (Beispiel: https://deinedomain.udemy.com/developers/organization/reporting/methods/organizationuseractivity-list/get/).
- Füge die Client-ID und das Client-Passwort ein. Dadurch wird ein Autorisierungs-Token erzeugt, denn du dann in Power BI eingibst.
- Kopiere den Wert von „Authorization“ und öffne die Datei PowerBI_Template. Ersetze [insert-token] durch den Wert von „Authorization“, ersetze [insert-customer-domain] durch deine Domain und ersetze [insert-AccountID] durch den Wert von „Organization_ID“. Speichere dann die Datei.
- Öffne Power BI Desktop.
- Erstelle eine neue DataSource – Web (Datenquelle – Web) und gib die Homepage deines Unternehmens ein (Beispiel: https://yourdomain.udemy.com/organization/home/) (anonyme Authentifizierung).
- Schließe das Browserfenster und öffne „DataSource – Blank Query“ (Datenquelle – Leere Abfrage).
- Klicke auf „Advanced Editor“ (Erweiterter Editor). Wähle alle Informationen aus, die du in PowerBI_Template gespeichert hast, und kopiere sie hier hinein.
- Speichere die Abfrage.
Hinweis: Wenn dir die Fehlermeldung „The column 'Column1' was not found“ (Die Spalte 'Spalte 1' wurde nicht gefunden) angezeigt wird, bedeutet dies, dass keine Daten vorhanden sind.
-
So findest du deine API-Anmeldedaten in Udemy Business
Artikel lesenIn diesem Artikel wird erklärt, wie Administratoren ihre API-Anmeldedaten für die Integration von Udemy Business in Lernmanagement-Systeme (LMS) und Learning-Experience-Plattformen (LXP) oder andere benutzerdefinierte Integrationen finden, die die Udemy Business-REST-APIs nutzen.
Wichtiger Hinweis:
- APIs sind nur für Kunden mit einem Enterprise-Abo verfügbar.
- Die Informationen in diesem Artikel gelten nicht für xAPI-Anmeldedaten. Die xAPI-Anmeldedaten findest du in dem System, in das die Udemy Business-Daten übertragen werden sollen. Weitere Infos findest du in diesem Artikel zur Udemy Business-Integration über xAPI.
- Weitere Informationen zu den verfügbaren Integrationen findest du unter LMS- und LXP-Integrationspartner.
Für die Udemy Business-REST-API sind die folgenden Anmeldedaten verfügbar. Wenn die API bereits aktiviert ist, findest du die Anmeldedaten unter den folgenden URLs, indem du {{Unternehmensname}} durch deine eigene Subdomain ersetzt.
- Client-ID und Client-Passwort
- https://{{Unternehmensname}}.udemy.com/organization-manage/settings/lms-integration/
- Unternehmens-ID (Account_ID)
- https://{{Unternehmensname}}.udemy.com/developers/organization/courses/
- https://{{Unternehmensname}}.udemy.com/developers/organization/reporting/
- Unternehmensname (Kontoname)
- Dies ist die Subdomain deiner URL: https://{{Unternehmensname}}.udemy.com
- Hinweis: Wenn du SumTotal verwendest, ist der Unternehmensname die vollständige URL: https://{{Unternehmensname}}.udemy.com
Wenn die API noch nicht aktiviert ist, führe die folgenden Schritte aus, um die API zu aktivieren und die Anmeldedaten abzurufen:
So aktivierst und findest du deine API-Anmeldedaten in Udemy Business
- Klicke rechts oben in Udemy Business auf Verwalten > Einstellungen.
- Klicke in der Seitenleiste auf LMS/LXP-Integrationen und dann auf Einrichtung beginnen. Wähle im Dropdown-Menü das gewünschte Integrationssystem aus oder klicke auf Sonstiges, wenn dein Tool nicht aufgeführt ist. Klicke auf Speichern. Die API ist nun aktiviert.
- Nachdem die API aktiviert wurde, kannst du deine API-Anmeldedaten abrufen. Die Client-ID und das Client-Passwort sind nun unter Verwalten > Einstellungen > LMS/LXP-Integrationen verfügbar.
- Für deine Unternehmens-ID (Konto-ID) musst du zunächst in der linken Seitenleiste auf API klicken. Klicke dann auf einen der Links für die API-Dokumentation.
- Scrolle ungefähr bis zur Hälfte der Seite bis zum Abschnitt Dein API-Client und deine Konto-ID herunter. Hier findest du deine Account_ID (identisch mit der Unternehmens-ID).
- Als Nächstes brauchst du den Unternehmensnamen/Kontonamen: Das ist ganz einfach die Subdomain deiner Udemy Business-URL:
Jetzt kannst du mit den API-Anmeldedaten von Udemy Business die Integration in das gewünschte LMS/LXP- oder ein anderes System vornehmen.
Falls du weitere Fragen zu unseren APIs oder der Integrationseinrichtung hast, kontaktiere bitte deinen Customer-Success-Manager.
-
Referenz für die Udemy Business-API
Artikel lesenUdemy Business (UB) bietet drei RESTful-APIs (für Kurse, Lernpfade und Berichte), die es Entwicklern ermöglichen, den Udemy Business-Kurskatalog, öffentliche Lernpfade und die Daten zu den Kursaktivitäten der Nutzer programmgesteuert abzurufen. Diese drei APIs können zur Integration in Anwendungen anderer Hersteller verwendet werden, beispielsweise in ein Lernmanagement-System (LMS).
Wichtiger Hinweis:
- APIs sind nur für Kunden mit einem Enterprise-Abo verfügbar.
- Die Verfügbarkeit dieser APIs aktiviert nicht automatisch die Integration in ein LMS/LXP.
- Zur Erfassung der Daten in einem LMS/LXP muss mithilfe dieser APIs ein Connector erstellt werden. Wenn du mehr darüber erfahren möchtest, kontaktiere bitte deinen Customer-Success- oder LMS/LXP-Ansprechpartner.
- Die API-Dokumentation ist nur auf Englisch verfügbar.
- Die Udemy-API-Lizenzvereinbarung findest du unter: https://www.udemy.com/terms/api/
- Hinweis: In Abhängigkeit von dem Vertrag, den dein Unternehmen für sein Udemy Business-Konto abgeschlossen hat, können für dich zusätzliche oder andere Nutzungsbedingungen gelten, die in dem von deinem Unternehmen unterschriebenen Vertrag aufgeführt sind.
- Weitere Informationen findest du in der folgenden Dokumentation sowie in unserem Guide zu den Udemy Business-APIs.
1. Dokumentation der Udemy Business-API – RESTful-APIs
-
- Kurs-API
- Lernpfad-API
- Kursberichts-API
2. Dokumentation der Udemy Business-xAPI
-
- Die xAPI unterstützt die Meldung von Nutzerfortschritten und Kursabschlüssen in Echtzeit.
-
Leitfaden zu den Udemy Business-APIs
Artikel lesenDieser Guide beschreibt bewährte Verfahrensweisen, um dich bei der Integrationsentwicklung unter Verwendung der Udemy Business-APIs zu unterstützen. Wenn du diese Tipps und Hinweise umsetzt, sorgst du für ein bestmögliches Lernerlebnis deiner Nutzer.
Falls bei der Entwicklung Fragen aufkommen, steht dir unser Sales & Solutions Engineering-Team gern unterstützend zur Seite. Kontaktiere dann einfach deinen Ansprechpartner bei Udemy Business, um einen Gesprächstermin zu vereinbaren.
Hier geht's zur vollständigen API-Dokumentation von Udemy.
Dieses Dokument wurde zuletzt am 31. Mai 2023 aktualisiert.
Inhalt:
- Funktionsweise
- Zugriff auf Kurse bei Udemy und bei Drittanbieter-Systemen
- Häufigkeit von Katalogaktualisierungen
- Empfohlene Kursdaten
- Effiziente API-Aufrufe
- Seitenlänge
- Synchrone API-Aufrufe
- Kurskategoriestruktur
- Sprachcodes
- Individuelle Kurskataloge
- Neue und zurückgezogene Kurse
- Nicht von der Kurslisten-API abgedeckte Daten
- Übersicht
- Berichts-xAPI
- Berichts-RESTful-API
- Empfohlener Endpunkt
- Aktualisierungshäufigkeit der Berichts-API
- Berichtsdaten
- Fortschritt und Abschluss
- Nicht von der Berichts-API und xAPI abgedeckte Daten
1. Grundlegende Infos zu APIs
Authentifizierung & SSO
Hinweis: Die Authentifizierungs- und Nutzerverwaltung innerhalb von Udemy Business arbeitet unabhängig bzw. separat von deinem LMS/LXP-System (Lernmanagement-System/Learning-Experience-Plattformsystem). Wenn Nutzer also über ein LMS/LXP-System auf Kurse von Udemy Business zugreifen wollen, können sie diese Kurse nur belegen, wenn sie über eine Udemy Business-Lizenz verfügen. Udemy Business unterstützt die Nutzerverwaltung über verschiedene Mechanismen: Standard-Nutzername/-Passwort, E-Mail-Domain-Zugriff und SSO (Single Sign-On).
Fehlerbehandlung und Aufrufratenlimits
429-Fehler
- Bei allen Udemy-APIs bestehen Aufrufratenlimits. Bei einer Überschreitung dieses Limits wird eine 429-Fehlermeldung mit einem Retry-After-Header zurückgegeben. Implementiere deshalb am besten eine Wiederholungsroutine, die dafür sorgt, dass weitere Aufrufe bzw. Anfragen erst nach Ablauf der im Header angegebenen Sekundenzahl gestellt werden.
- Hinweis: Die Aufrufratenlimits bei Udemy können sich jederzeit ändern. Die Logik der implementierten Wiederholungsroutine sollte deshalb nicht mit festen Zahlen arbeiten, sondern auf dem Wert in der zurückgegebenen 429-Fehlermeldung basieren.
50X-Fehler
- Auch für 502/503-Fehler sollten Wiederholungsroutinen implementiert werden. Wenn beim Zugriff auf den Endpunkt der Kursliste 50X-Fehler zurückgegeben werden, kannst du dies ggf. für zukünftige Aufrufe verhindern, indem du den Wert des „page_size“-Parameters verringerst.
- Außerdem empfehlen wir das Implementieren von nutzerbezogenen Mechanismen zur erneuten Synchronisierung des Kurskatalogs und zur Aktualisierung der Berichtsdaten.
2. Kurslisten-API
Funktionsweise
Mit der Kurslisten-API von Udemy Business kannst du alle Kurse und die zugehörigen Metadaten in dein System abrufen, um dort bequem innerhalb der vorhandenen Drittanbieter-Plattformen (dein LMS-, LXP- oder anderes System) im Udemy Business-Kursangebot suchen und auf die Kurse zugreifen zu können. Die Kursintegration enthält nicht nur grundlegende Daten wie Titel, Kursbeschreibung, Thumbnail usw., sondern auch einen Kurs-URL-Deep-Link, über den der Nutzer automatisch von deinem LMS/LXP-System zurück auf die Udemy Business-Instanz deines Unternehmens geleitet wird und den entsprechenden Kurs dann in Udemy Business belegen kann.
Das Einbetten bzw. Nutzen des Udemy Business-Kurses innerhalb des Drittanbieter-Systems ist mit der Integration dagegen nicht möglich. Dies vermeidet zum einen den Aufwand des zusätzlichen Hostings derselben Inhalte auf anderen Systemen und sorgt zum anderen für ein optimales Lernerlebnis, da die Kurse auf die Nutzung innerhalb der Udemy-Umgebung abgestimmt sind und nur dort der Zugriff auf zusätzliche Funktionen, wie Lern-Tools, Austausch mit den Dozenten u. ä. möglich ist.
Udemy Business unterstützt in der API-Konfiguration außerdem die optionale Einstellung zur automatischen Kurseinschreibung. Wenn diese für Integrationen empfohlene Einstellung aktiviert ist, werden Nutzer automatisch in den Kurs eingeschrieben, wenn sie im LMS/LXP-System auf einen Kurs-Link klicken.
Zugriff auf Kurse bei Udemy und bei Drittanbieter-Systemen
Bei einigen LMS/LXP-Systeme ist es möglich einzuschränken, welche Nutzer innerhalb des LMS/LXP-Systems auf welche Kurse zugreifen können. Abgesehen von nicht öffentlichen unternehmensinternen Kursen und Lernpfaden können alle Udemy Business-Nutzer innerhalb von Udemy Business auf den gesamten öffentlichen Kurskatalog zugreifen und sich in diese Kurse einschreiben. Dies ist für unsere Kunden zwar kein Problem, wir möchten dich aber darauf hinweisen, dass bei diesen Funktionen leichte Unterschiede zwischen deinem LMS/LXP-System und Udemy Business bestehen können.
Häufigkeit von Katalogaktualisierungen
Da wir am Kurskatalog immer wieder Änderungen vornehmen, empfehlen wir, den Katalog täglich zu aktualisieren. Dies sollte automatisch ablaufen und kein manuelles Eingreifen des Endnutzers erfordern. Wir empfehlen, die Aktualisierung zu einem Zeitpunkt mit möglichst geringer Nutzung ausführen zu lassen (idealerweise 03:00 Uhr UTC).
Empfohlene Kursdaten
Über die API können große Mengen an Kurs-Metadaten bereitgestellt werden. Wir empfehlen, mindestens die hier angegebenen Datenpunkte zu nutzen, um für ein optimales Nutzererlebnis zu sorgen:
API-Feld
Empfehlung
title
description
primary_category
primary_subcategory
Nutze diese Felder für den Abgleich mit dem vom Nutzer eingegebenen Suchbegriff.
images[]
Eine Bild-URL, die ein Bild des Kurses für den Nutzer ausgibt
url
mobile_native_deeplink
Deep-Links zum Kurs in der Umgebung des Kunden innerhalb der Web-App bzw. Mobile-App von Udemy
locale
Der Udemy Business-Katalog enthält Kurse in verschiedenen Sprachen, dein System muss diese auf jeden Fall erkennen und filtern können.
estimated_content_length
Wird in Minuten angegeben, optimal zur Anzeige für Nutzer geeignet und kann für Berichterstellung/Gamification für Nutzer verwendet werden
level
Kurslevel (Anfänger, Mittelstufe, Experte)
Effiziente API-Aufrufe
Je nach der Sprachauswahl des Kunden kann der Udemy Business-Katalog 6.000 bis 23.000 Kurse umfassen. Da eine Seite max. 100 Einträge enthält, werden für den Abruf aller Kurse 60 bis 230 API-Rückgaben benötigt. Langfristig gesehen zahlt es sich aus, dein System so einzurichten, dass dieser Prozess reibungslos ablaufen kann. Wenn du hierzu eine persönliche Beratung benötigst, wende dich an den für dich zuständigen Solutions-Techniker bei Udemy.
Seitenlänge
- Das Limit für „page_size“ beträgt 100 Datensätze.
- Falls es bei Aufrufen dieser Art zu Verzögerungen oder 502-Fehlern kommt, dann verringere den „page_size“-Wert um die Hälfte und versuche es noch mal.
- Die Gesamtanzahl von Kursen ist in der Antwort angegeben („count“).
- Die Seitenanzahl kannst du aus „count“ und „page_size“ ermitteln, d. h., wenn z. B. „count“ = 1000 und die Seitenlänge „page_size“ = 100 ist, müssen 10 Aufrufe durchgeführt werden.
- Ändere für jeden Aufruf den Parameter für die Seitennummerierung („page“).
- https://{{KONTO_NAME}}.udemy.com/api-2.0/organizations/{{KONTO_ID}}/courses/list/?fields[course]=@all&page=1
- Du kannst die nächste auch Seite abrufen, indem du den nächsten, in der Antwort ausgegebenen Wert verwendest.
Synchrone API-Aufrufe
- Für ein effizienteres Abrufen des Kurskatalogs empfehlen wir die Verwendung von synchronen Aufrufen.
- Während des Abrufprozesses für die Kursseiten kann es aus unterschiedlichsten Gründen passieren, dass einzelne Seiten nicht korrekt abgerufen werden. Dieser Fall sollte unbedingt abgefangen und ein Mechanismus implementiert werden, der für einen erneuten Abruf der fehlerhaften bzw. nicht abgerufenen Seite sorgt.
- Hierfür sind synchrone API-Aufrufe und Warteschlagen-Konzepte optimal geeignet, da diese eine geordnete Abfolge von planmäßigen und wiederholten Seitenaufrufen ermöglichen. Bei asynchronen API-Aufrufen kann es zum einen durch zu viele gleichzeitige Aufrufe zur Überlastung der API kommen, zum anderen erschweren sie den Überblick darüber, welche Seiten innerhalb der Abfolge ggf. nicht abgerufen wurden. Wir empfehlen, den Ablauf so zu implementieren, dass erst nach dem erfolgreichen Abrufen einer Kursseite mit dem Abrufen der nächsten Seite begonnen wird.
Kurskategoriestruktur
Hier findest du die aktuelle Kurskategoriestruktur. Es handelt sich dabei um eine Liste der Kategorien und Unterkategorien, die über die API auf deinem System abgebildet werden können. Hinweis: Diese Struktur ist nicht für alle Sprachen identisch und kann auch im Laufe der Zeit immer wieder verändert werden.
Sprachcodes
Im Folgenden findest du eine Liste der in Udemy Business vorhandenen Sprachen und deren Codes. In der heruntergeladenen Kursliste von Udemy gibt es für jeden Kurs ein Feld für die Sprache. Die beiden ersten Kleinbuchstaben geben die grundsätzliche Sprache des Kurses an, die beiden anderen Buchstaben geben die Sprachregion an, was beispielsweise für Untertitel o. ä. nützlich ist. Beispielsweise gibt es für Englisch u. a. den Code „en_GB“ für britisches Englisch und „en_US“ für US-amerikanisches Englisch.
Arabisch – ar
Indonesisch – id
Englisch – en
Französisch – fr
Deutsch – de
Hindi – hi
Italienisch – it
Japanisch* – ja
Koreanisch* – ko
Mandarin – zh
Polnisch – pl
Portugiesisch – pt
Russisch – ru
Spanisch – es
Türkisch – tr
Individuelle Kurskataloge
Der Udemy Business-Kurskatalog wird individuell auf jeden Kunden zugeschnitten und ist dann ausschließlich für diesen Udemy Business-Kunden verfügbar. Der Katalog jedes Kunden setzt sich aus unterschiedlichen Sprachpaketen, unternehmensinternen Kursen und von udemy.com importierten Kursen zusammen, die über die Kurslisten-API in ihrer Gesamtheit abgerufen werden. Aus diesem Grund muss für jedes Unternehmen, das gegenüber Udemy Business ein eigenständiger Kunde ist, ein separater, individueller Kurskatalog geführt werden.
Neue und zurückgezogene Kurse
- Der Inhalt des Kurskatalogs kann sich jederzeit verändern, da immer wieder neue Kurse hinzugefügt und veraltete Kurse zurückgezogen werden.
- Wenn du den Kurskatalog nutzt, um alle Kurse abzurufen und sie in die interne Datenbank deines Unternehmens zu laden, ist es wichtig, zurückgezogene Kurse, die nicht mehr in der aktuellen Kurslistenausgabe enthalten sind, zu entfernen oder entsprechend zu kennzeichnen.
- Ein einmal zurückgezogener Kurs ist nicht mehr in der von der Kurslisten-API ausgegebenen Liste enthalten und Nutzer können sich bei Udemy nicht mehr in den Kurs einschreiben. Wenn ein Kurs aus dem Udemy Business-Kurskatalog zurückgezogen wird, dann behalten alle Nutzer, die zum Zeitpunkt der Zurückziehung in diesen Kurs eingeschrieben sind, ihren Zugriff. Wenn sich ein Nutzer allerdings von einem Kurs abmeldet, der zurückgezogen wurde, kann er ab dann nicht mehr auf diesen Kurs zugreifen. Außerdem können neue Nutzer nicht mehr auf den Kurs zugreifen bzw. sich einschreiben.
Nicht von der Kurslisten-API abgedeckte Daten
Beachte bitte, dass die API für den Udemy Business-Kurskatalog nicht auf alle Kursdaten Zugriff bietet. Folgendes ist derzeit nicht verfügbar bzw. möglich:
- Einbetten bzw. Hosting von Kursen
- Udemy Business-Content kann nicht außerhalb von Udemy Business eingebettet oder gehostet werden. Du musst die Nutzer hierfür von deinem LMS/LXP-System zurück zu Udemy Business leiten.
- Kursbewertungen (Sterne)
- Diese sind im Kurs-API-Endpunkt nicht enthalten. Hinweis: Viele LMS/LXP-Systeme bieten ein eigenes Kursbewertungskonzept, das von deinen Nutzern weiterhin unabhängig vom Udemy-Bewertungssystem genutzt werden kann.
- Kursrezensionen (Kommentare)
- Daten zu Einschreibungen
- Such- und Entdeckungsfunktion
- Udemy Business nutzt ein eigenes Konzept zur Anzeige von Suchergebnissen und Kursempfehlungen, das auf Beliebtheit, Bewertung usw. der Kurse beruht. Dieses Konzept wird nicht an Tools bzw. Systeme von Drittanbietern übertragen. Udemy Business hat keinen Einfluss darauf, welche Suchergebnisse oder Kursempfehlungen diese Tools bzw. Systeme anbieten.
- Lernpfade und Udemy Pro-Pfade
- Diese sind separat und stehen nicht in unmittelbarem Zusammenhang mit den Kursen, weshalb sie auch nicht in die Kurskatalog-Synchronisierung einbezogen werden. Wir verfügen jedoch über einen separaten Lernpfad-API-Endpunkt, den du für den Import der Udemy Business-Lernpfade und der Udemy Pro-Lernpfade nutzen kannst.
- Daten auf Lektionsebene
- Über die APIs von Udemy Business werden vollständige Kurse und Lernpfade übertragen. Teile von Kursen, wie z. B. einzelne Kursabschnitte, Lektionen, Quizze u. ä., können nicht übertragen werden.
- Wenn du einzelne Kurskomponenten für die Erstellung von benutzerdefinierten Lernpfaden oder Lernprogrammen benötigst, empfehlen wir, die entsprechenden Lernpfade in Udemy Business zu erstellen und diese anschließend mithilfe unseres Lernpfad-API-Endpunkts in dein LMS/LXP-System zu importieren.
- Labs, Wissenstests und Workspaces von Udemy Business Pro
- Labs, Wissenstests und Workspaces lassen sich nicht in Drittanbieter-Systeme integrieren, sondern müssen direkt in Udemy Business gestartet werden.
- Der gleichzeitige Upload mehrerer Kurse auf Udemy per API ist nicht möglich, da unsere API nur für den Abruf von auf Udemy vorhandenen Kursdaten konzipiert ist.
3. Lernpfad-APIs
Übersicht
Ähnlich dem Kurslisten-API-Endpunkt für Udemy-Kurse bietet Udemy Business auch einen Lernpfad-API-Endpunkt, der das Suchen und Zugreifen auf deine Udemy Business-Lernpfade von Drittanbieter-Plattformen aus ermöglicht (z. B. bestehendes LMS/LXP- oder anderes System).
Lernpfade sind eine Zusammenstellung von Kursen, einzelnen Lektionen, individuellen Inhalten und Links, die den Nutzer gezielt durch das Erlernen eines bestimmten Themas oder Fachgebiets leiten.
Die für Lernpfade zurückgegebenen Daten ähneln weitgehend den Daten, die über den Kurslisten-API-Endpunkt abgerufen werden können. Beachte dabei aber bitte, dass Lernpfade ein von Kursen vollständig separates Objekt sind, das auch als solches behandelt werden muss.
Für die wichtigsten Nutzungsszenarien bei der Integration von Udemy Business ist das Entwickeln eines Connectors zur Nutzung der Lernpfad-API zwar keine Grundvoraussetzung, kann aber auf lange Sicht dazu beitragen, den Leistungs- und Funktionsumfang der Integration bestmöglich auszunutzen.
4. Berichts-APIs
Übersicht
Die Berichts-API von Udemy Business gibt dir eine Übersicht darüber, wie deine Nutzer den Content nutzen. Du kannst beispielsweise nachvollziehen, wer welche Kurse wie häufig nutzt, welche Nutzer am intensivsten lernen, wer möglicherweise Unterstützung braucht und vieles mehr. Im Hinblick auf die übergeordneten Weiterbildungs- und Entwicklungsziele können diese Daten und Übersichten eine wertvolle Orientierungshilfe sein. Es kann hilfreich sein, aus Udemy Business exportierte Berichtsdaten im LMS/LXP-System anzuzeigen, auch können sie so mit anderen Daten oder Berichterstellungsfunktionen anderer externer Systeme kombiniert oder ergänzt werden.
Für das Abrufen von Berichtsdaten von Udemy gibt es zwei Möglichkeiten: xAPI und die REST-Berichts-API. Ausführliche Infos über die Unterschiede zwischen beiden Möglichkeiten findest du unter Vorteile der xAPI.
Berichts-xAPI
- Udemy sendet Fortschritts- und Abschlussereignisse nahezu in Echtzeit an den von dir angegebenen Endpunkt. Auf diese Weise ist keine wiederholte Abfrage der Udemy-API erforderlich.
- Wir empfehlen xAPI, sofern deine Plattform dies unterstützt, da dieser Standard mittlerweile von immer mehr Lernsystemen übernommen wird.
- Beachte dabei bitte, dass die Berichts-xAPI derzeit nicht so viele Datenelemente wie die RESTful-API umfasst.
- Beispielsweise wird die Lernzeit, die ein Nutzer für den Kurs aufgewendet hat, nicht in der xAPI-Anweisung gesendet.
Berichts-RESTful-API
Diese API muss regelmäßig aufgerufen werden, hierbei werden die Daten aus dem Endpunkt der Berichts-REST-API in das LMS/LXP-System abgerufen. Dies läuft nicht in Echtzeit ab, außerdem sind regelmäßige Abrufe erforderlich, um die Datensätze aktuell zu halten.
Empfohlener Endpunkt
Für Fortschritts- und Abschlussdaten: „user-course-activity“. Mithilfe von„from_date“ und „to_date“ können die Ergebnisse auf einen bestimmten Zeitraum eingeschränkt werden.
- https://{{KONTO_NAME}}.udemy.com/api-2.0/organizations/{{KONTO_ID}}/analytics/user-course-activity/?page=1&from_date=2022-05-21&to_date=2022-05-22&page_size=100
- Wir empfehlen einen 2-tägigen Datumszeitraum, bestehend aus dem aktuellen und dem Datum des vergangenen Tages, um sicherzugehen, dass nicht nur möglichst aktuelle Daten, sondern auch sog. „Sunset“-Daten (im unmittelbaren Umfeld des Tagesendes bzw. Aktualisierungszeitpunkts erzeugte Daten) erfasst werden.
Aktualisierungshäufigkeit der Berichts-API
- Alle 4 Stunden
- Hinweis: Unsere REST-API-Daten werden 3x pro Tag aktualisiert.
- Bei einem Intervall von 4 Stunden kann Udemy zukünftig ggf. auch häufigere Aktualisierungen durchführen, ohne dass hierfür Veränderungen an der Integration vorgenommen werden müssen.
Berichtsdaten
Datenelement
Details
course_id
Die eindeutige ID des Kurses
user_email
Die eindeutige ID des Nutzers
completion_ratio
Der prozentuale Anteil des Kurses, den ein Nutzer bereits abgeschlossen hat.
Beachte bitte, dass sich dieser Anteil aufgrund von Änderungen am Kurs ändern kann.
Wird z. B. zu einem zu 100 % abgeschlossenen Kurs eine neue Lektion hinzugefügt, sinkt der Anteil auf 80 %.num_video_consumed_minutes
Optimal geeignet für interne LMS-Kennzahlen, zum Nachvolllziehen von Kursnutzung, insgesamt konsumierten Minuten / Fortbildungseinheiten (Credits).
course_first_completion_date
Gibt an, ob der Nutzer den Kurs bereits zu irgendeinem früheren Zeitpunkt abgeschlossen hatte
course_completion_date
Gibt an, wann der Nutzer den Kurs zuletzt abgeschlossen hat.
Der Wert kann auch NULL sein, wenn sich der Nutzer vom Kurs abgemeldet hat.user_external_id
Wird als externe ID verwendet, die für den Nutzer eindeutig ist. (Nur, wenn die E-Mail-Adresse keine gültige eindeutige ID darstellt.)
lms_user_id
Wird als externe ID verwendet, die für das LMS eindeutig ist. (Nur, wenn die E-Mail-Adresse keine gültige eindeutige ID darstellt.)
Fortschritt und Abschluss
- Deine Integration sollte sowohl Fortschritts- als auch Abschlussereignisse aufnehmen.
- Dies sollte für alle genutzten Udemy Business-Kurse der Fall sein, einschließlich zurückgezogener Kurse und Kurse, die nicht von der Plattform deines Unternehmens aus gestartet wurden.
Nicht von der Berichts-API und xAPI abgedeckte Daten
- Udemy Business Pro-Berichte
- Der Lab-Nutzeraktivitätsbericht und der Wissenstest-Nutzeraktivitätsbericht können bislang nur direkt über die Udemy-Verwaltungseinstellungen heruntergeladen werden.
- Lernpfad-Berichte
- Diese Berichte sind bislang nicht über APIs verfügbar, sondern können nur direkt über die Udemy-Verwaltungseinstellungen heruntergeladen werden.
5. Ausblick
Wir arbeiten kontinuierlich an der Verbesserung unserer APIs und eingesetzten Technologien.
- GraphQL: Es ist eine Aktualisierung der Kurskatalog-APIs geplant, die eine Nutzung der GraphQL-Architektur ermöglicht. Hier findest du Infos zum allgemeinen GraphQL-Konzept. Dies hat mehrere Vorteile, u. a. können Abfragen der Kurskatalog-APIs durchgeführt werden, die nur die bei diesem spezifischen Aufruf benötigten Daten zurückgeben. Die Veröffentlichung der Udemy-GraphQL-APIs ist für das 3. Quartal 2023 geplant.
- Such-API: Anhand der vielen Suchen, die Nutzer in unserem über 200.000 Kurse umfassenden Katalog durchführen, und der ausgegebenen Kursempfehlungen haben wir umfassendes Wissen zu Such- und Empfehlungsroutinen gesammelt. Unsere Suchfunktionen können dir hier sicher eine gute Unterstützung sein. Der Start der Suchfunktionen ist für das 3. Quartal 2023 geplant.
6. Feedback?
Hast du Feedback zu diesem Dokument oder vermisst du bestimmte Informationen? Dann würden wir uns freuen, von dir zu hören. Sende dein Feedback bzw. deine Vorschläge bitte an partnerships@udemy.com. Danke im Voraus!
-
Die Zahlungsmethode für dein Team-Abo-Konto aktualisieren
Artikel lesenIn diesem Artikel wird erklärt, wie Administratoren eines Team-Abo-Kontos die gespeicherte Zahlungsmethode aktualisieren oder eine gespeicherte Zahlungskarte entfernen können.
So aktualisierst du die gespeicherte Zahlungsmethode
Administratoren eines Team-Abo-Kontos können die für das Konto gespeicherte Zahlungsmethode wie folgt aktualisieren:
- Melde dich bei deinem Udemy Business-Konto an.
- Gehe zu Verwalten > Einstellungen > Abrechnung.
- Klicke auf Zahlungsmethode hinzufügen.
- Gib die Kartendaten ein.
- Klicke auf Karte speichern.
So entfernst du eine gespeicherte Karte
Du entfernst eine gespeicherte Zahlungsmethode wie folgt:
- Melde dich bei deinem Udemy Business-Konto an.
- Gehe zu Verwalten > Einstellungen > Abrechnung.
- Klicke im Bereich Zahlungsmethode auf das entsprechende Mülltonnensymbol.
-
Kontoinhaber: Datenmigration genehmigen
Artikel lesenIn diesem Artikel wird erklärt, wie Kontoinhaber die Migration von Lerndaten genehmigen können, wenn sie eine Anfrage zur Zusammenführung von Udemy Business-Sites, die zu ihrem Unternehmen gehören, erhalten haben.
- Hier findest du weitere Infos über die Zusammenführung mehrerer Udemy Business-Sites.
Hinweis: Nachdem beide Kontoinhaber die Migration genehmigt haben, wird die Ausgangs-Site in den Wartungsmodus versetzt, d. h., die Nutzer können dann nicht mehr auf Udemy Business zugreifen. Lies bitte unbedingt den folgenden Abschnitt zum Wartungsmodus.
Inhalt
- Datenmigrationsprozess beginnen
- Genehmigungsprozess für die Ausgangs-Site
- Genehmigungsprozess für die Ziel-Site
- Wichtige Informationen zum Wartungsmodus nach der Genehmigung
- Wichtiger Hinweis zur SSO- und SCIM-Integration
Datenmigrationsprozess beginnen
Nachdem dein Customer-Success-Partner den Migrationsprozess begonnen hat, erhalten die Kontoinhaber beider Sites (Udemy Business-Ausgangs- und -Ziel-Site) eine E-Mail, um die Migration zu genehmigen.
Genehmigungsprozess für die Ausgangs-Site
Wenn du der Kontoinhaber der Ausgangs-Site bist:
1. Klicke auf Genehmigungsprozess starten und befolge dann die Anweisungen zur Anmeldung bei deinem Udemy Business-Konto.
Wichtiger Hinweis: Wenn du dich über SSO (Single Sign-On) anmeldest und auf die Homepage zurückgeleitet wirst, dann klicke erneut auf den Button „Genehmigungsprozess starten“, um den Vorgang fortzusetzen.
2. Gib die Ziel-URL ein (die Adresse, zu der die Daten migriert werden sollen) und klicke dann auf Weiter.
Achte unbedingt darauf, die korrekte URL einzugeben. Bei Eingabe einer falschen URL wird eine Fehlermeldung angezeigt und du kannst den Vorgang nicht fortsetzen.
3. Prüfe die Angaben, setze ein Häkchen in der Checkbox und klicke auf Genehmigen, um der Migration der Daten zuzustimmen.
4. Dir wird dann in einer Popup-Meldung bestätigt, dass die Migration läuft.
Genehmigungsprozess für die Ziel-Site
Wenn du der Kontoinhaber der Ziel-Site bist:
1. Klicke auf Genehmigungsprozess starten und befolge dann die Anweisungen zur Anmeldung bei deinem Udemy Business-Konto.
Wichtiger Hinweis: Wenn du dich über SSO (Single Sign-On) anmeldest und auf die Homepage zurückgeleitet wirst, dann klicke bitte erneut auf den Button „Genehmigungsprozess starten“, um den Vorgang fortzusetzen.
2. Gib die Ausgangs-URL ein (die Adresse, von der die Daten migriert werden sollen) und klicke dann auf Weiter.
Achte unbedingt darauf, die korrekte URL einzugeben. Bei Eingabe einer falschen URL wird eine Fehlermeldung angezeigt und du kannst den Vorgang nicht fortsetzen.
3. Prüfe die Angaben, setze ein Häkchen in der Checkbox und klicke auf Genehmigen, um der Migration der Daten zuzustimmen.
4. Dir wird dann in einer Popup-Meldung bestätigt, dass die Migration läuft.
Wichtige Informationen zum Wartungsmodus nach der Genehmigung
Nachdem beide Kontoinhaber die Migration genehmigt haben, wird die Ausgangs-Site in den Wartungsmodus versetzt, d. h., die Nutzer können dann nicht mehr auf diese Udemy Business-Site zugreifen. Alle Integrationen, wie z. B. SSO, SCIM oder LMS, werden in der Ausgangs-Site ebenfalls deaktiviert, um die zu migrierenden Daten erhalten.
Wichtiger Hinweis zur SSO- und SCIM-Integration
Die SSO- und SCIM-Integration werden im Rahmen des Migrationsprozesses für die Ausgangs-Site deaktiviert. Nach dem Abschluss der Migration müssen Administratoren den migrierten Nutzern bei ihren Identitätsanbietern Zugriff für SSO und SCIM gewähren.
- Informiere dich über SSO und die wichtigsten SSO-Funktionen bei Udemy Business.
- Informiere dich über die Automatisierung der Nutzer- und Gruppenverwaltung mit SCIM.
-
Services für die Zusammenführung mehrerer Udemy Business-Sites anfordern
Artikel lesenIn diesem Artikel werden der Umfang und die verfügbaren Optionen einer genehmigten Anforderung zur Zusammenführung deiner Udemy Business-Sites beschrieben.
Wichtiger Hinweis: Wenn die Anforderung noch nicht genehmigt ist, dann kontaktiere bitte deinen Customer-Success-Partner. Udemy behält sich das Recht vor, Anforderungen auf ihren Umfang und ihre praktische Umsetzbarkeit zu prüfen. Wenn in deinem Unternehmen beispielsweise zwei Udemy Business-Sites vorhanden sind (z. B. die lokale Site de-unternehmen.udemy.com und die internationale Site unternehmen.udemy.com), dann kannst du eine Zusammenführung anfordern. Dabei werden die Nutzer und ihre bisherigen Lernaktivitäten von einer Site in eine andere Domain übertragen und in diese integriert.
Udemy Business unterstützt die Zusammenführung von Sites mit einem Enterprise- oder Team-Abo in eine Site mit einem Enterprise-Abo. Die Zusammenführung von zwei Sites mit einem Team-Abo oder die Zusammenführung einer Site mit einem Enterprise-Abo in eine Site mit einem Team-Abo werden also nicht unterstützt.
Inhalt
- Gründe für die Zusammenführung mehrerer Udemy Business-Sites
- So forderst du die Migration der Daten in eine andere Udemy Business-Site an
- Migrierbare Daten
- Daten exportieren, die nicht migriert werden
- Wichtiger Hinweis zur SSO- und SCIM-Integration
Gründe für die Zusammenführung mehrerer Udemy Business-Sites
Dies sind einige mögliche Gründe für die Zusammenführung von Udemy Business-Sites:
- Dein Unternehmen hat mehrere Udemy Business-Konten, -Verträge und -Sites, die du zur Vereinheitlichung zusammenführen möchtest.
- Du möchtest, dass deine Nutzer ganz bequem auf einer Site auf Udemy Business zugreifen können.
- Die Daten zu den Lernaktivitäten (Lerner-Einblicke) sollen für das gesamte Unternehmen in einer zentralisierten Ansicht dargestellt werden.
- Dein Unternehmen fusioniert mit einem anderen Unternehmen oder wird von einem anderen Unternehmen übernommen und beide Udemy Business-Sites sollen zusammengeführt werden.
So forderst du die Migration der Daten in eine andere Udemy Business-Site an
1. Kontaktiere deinen Customer-Success-Partner.
2. Gib dabei bitte Folgendes an:
- Ausgangs-URL der Site, von der die Daten verschoben werden sollen.
- Ziel-URL der Site, in die die Daten migriert werden sollen.
3. Dein Customer-Success-Partner wird sich dann bei dir melden und dich informieren, wie es weitergeht.
Bitte beachten:
- Sobald die Migration begonnen hat, wird die Ausgangs-Site in den Wartungsmodus versetzt, d. h., die Nutzer können dann nicht mehr auf diese Udemy Business-Domain zugreifen.
- Die Ziel-Site muss über genügend freie Lizenzen verfügen, um die migrierten Nutzer aus der Ausgangs-Site aufnehmen zu können.
Migrierbare Daten
Migrierbare Arten von Daten, die durch dein Udemy Business-Abo abgedeckt sind
Udemy Business-Abos umfassen zurzeit die folgenden Arten von Daten, die von einer Site zu einer anderen übertragen werden können:
- Nutzerprofile
- Kurseinschreibungen
- Kursfortschritt
- Einblicke und Berichte
Arten von Daten, die über kostenpflichtige Serviceleistungen migriert werden können
Für die Migration bestimmter Arten von Daten von einer Site zu einer anderen sind zurzeit kostenpflichtige Services nötig. Dies umfasst u. a. die folgenden Arten von Daten:
- Nutzerrollen (Hinweis: Im Rahmen der Migration wird allen Nutzern die Rolle „Nutzer“ zugewiesen. In der Ziel-Site kann ihnen dann gegebenenfalls die Rolle „Administrator“ oder „Gruppenadministrator“ zugewiesen werden.)
- Importierte Kurse
- Informiere dich über das Importieren von Kursen von Udemy.com in dein Udemy Business-Konto.
- Wenn noch verfügbare Lizenzen für einen separat erworbenen kostenpflichtigen Kurs vorhanden sind, dann kontaktiere bitte den Udemy Business-Support, weil dieser Kurs dann in die Ziel-Site importiert werden muss.
- Gruppen
- Abschnitte
- Genehmigte Domain-Konfiguration
- LMS-Konfiguration
- SCIM-Daten
- SSO-Daten
- Offene Einladungen
- Kursausschlüsse (Wenn die Kursausschlüsse im Zielunternehmen aktiviert werden sollen, kontaktiere bitte den Udemy Business-Support.)
- Selbstdefinierte Kategorien
- Unternehmensinterne Kurse
- Unternehmensinterne Lernpfade
- Lernpfad-Einschreibungen
- Kurszuweisungen
Hinweis: Udemy bietet den kostenpflichtigen Service „Merge Orgs“ (Unternehmenszusammenführung) an, um Lücken bei der Migration zu überbrücken und für eine reibungslose Zusammenführung zu sorgen. Wenn du Interesse an diesem Service hast, dann frage bitte bei deinem Customer-Success-Partner nach. Arten von Daten, die nicht migriert werden können
Die folgenden Arten von Daten können derzeit nicht übertragen werden:
- Doppelt vorhandene Nutzer: Wenn Nutzer doppelt vorhanden sind, d. h. Nutzer mit der gleichen E-Mail-Adresse in beiden Sites, dann werden ihre Daten nicht migriert. Ihre Daten auf der Ziel-Site bleiben aber erhalten.
- Angaben zum Abonnement (sowie die verfügbaren Lizenzen)
Daten exportieren, die nicht migriert werden
Metadaten von ausgewählten Kursen, Lernpfaden, Gruppen und Bereichen können exportiert werden, damit die Kunden sie bei Bedarf in der Udemy Business-Ziel-Site wiederherstellen können.
- Informiere dich über das Erstellen und Herunterladen von Datenexportberichten.
- Informiere dich über das Erstellen und Herunterladen von Lernpfadberichten.
Wichtiger Hinweis zur SSO- und SCIM-Integration
Im Rahmen des Migrationsprozesses werden die SSO- und SCIM-Integration während der laufenden Zusammenführung in der Ausgangs-Site deaktiviert. Nach dem Abschluss der Migration müssen Administratoren den migrierten Nutzern bei ihren Identitätsanbietern Zugriff für SSO und SCIM gewähren.
- Informiere dich über SSO und die wichtigsten SSO-Funktionen bei Udemy Business.
- Informiere dich über die Automatisierung der Nutzer- und Gruppenverwaltung mit SCIM.
Kontoeinstellungen
-
Deine Kontoeinstellungen konfigurieren und anpassen
Artikel lesen -
Mein Konto anpassen
Artikel lesen -
Power BI zum Abrufen von Daten über die Udemy Business-API einrichten
Artikel lesen -
So findest du deine API-Anmeldedaten in Udemy Business
Artikel lesen -
Referenz für die Udemy Business-API
Artikel lesen -
Leitfaden zu den Udemy Business-APIs
Artikel lesen -
Die Zahlungsmethode für dein Team-Abo-Konto aktualisieren
Artikel lesen -
Kontoinhaber: Datenmigration genehmigen
Artikel lesen -
Services für die Zusammenführung mehrerer Udemy Business-Sites anfordern
Artikel lesen