-
Riepilogo delle API disponibili
Leggi l'articoloLe API di Udemy Business forniscono diverse funzionalità di integrazione per garantire una maggiore flessibilità nello sviluppo del software. In questo articolo sono illustrati alcuni dei potenziali utilizzi di ciascuna API e suggerimenti su quale scegliere.
- Consulta i Casi di utilizzo di integrazione dei partner supportati da Udemy
Indice
- Corsi e strumenti di apprendimento
- Reportistica
- Percorsi di apprendimento
- Single Sign-On (SSO)
- API legacy dei corsi
- Migliore integrazione consigliata
Corsi e strumenti di apprendimento
API GraphQL dei corsi - protocollo: GraphQL
- La nuova generazione e l'evoluzione delle API tradizionali dei corsi. In GraphQL, per ogni corso, vengono restituiti solo i metadati del corso specificato. Inoltre, utilizzando il sistema di query di GraphQL, vengono restituiti i corsi che corrispondono ai criteri specificati.
Nota: per saperne di più sulla tecnologia generale alla base di GraphQL, visita la pagina di GraphQL.API GraphQL degli strumenti di apprendimento - Protocollo: GraphQL
- Oltre ai corsi, Udemy offre numerosi strumenti di apprendimento. Ogni strumento di apprendimento può essere richiamato tramite API per essere integrato nel sistema. Questa API restituisce corsi, labs e badge. Come per gli altri servizi GraphQL, puoi utilizzare le query per ottenere solo gli strumenti e i campi specificati.
Documentazione: per consultare la documentazione relativa a GraphQL, è necessario avere accesso a Udemy Business. Visualizza il portale degli sviluppatori all'indirizzo https://{your_subdomain}.udemy.com/dev-portal/api-reference/
Reportistica
API di reportistica - protocollo: RESTful
- Questa API contiene tutti i dati dell'utente raccolti su progressi, completamenti e azioni legati al suo percorso di apprendimento. Puoi scegliere se ottenere i dati di reportistica di tutti gli utenti o se specificare un insieme di utenti. A causa della quantità di dati, può esserci un ritardo tra la raccolta delle azioni degli utenti e la loro pubblicazione nei report.
Documentazione: documentazione API Udemy Business - API RESTful
xAPI - protocollo: xAPI
- Reportistica in tempo reale, restituita tramite webhook, realizzata secondo gli standard xAPI EdTech. Udemy consente di ottenere i dati relativi ai progressi e alla reportistica in tempo reale. I dati contenuti in questi eventi in tempo reale hanno una portata minore rispetto alle API di reportistica RESTful.
Documentazione: documentazione xAPI Udemy Business
Percorsi di apprendimento
API dei percorsi di apprendimento - protocollo: RESTful
- Udemy consente agli studenti e agli amministratori in apprendimento e sviluppo (L&D) di creare percorsi di apprendimento, una raccolta di diversi corsi e qualsiasi altro tipo di strumento di apprendimento, compresi link esterni. È possibile richiamarli tramite API restituendo tutti i percorsi e gli elementi in essi contenuti.
Documentazione: documentazione API Udemy Business - API RESTful
Single Sign-On (SSO)
Udemy Business è in grado di connettersi a tutti i servizi Single Sign-On SAML 2.0, che includono la maggior parte dei provider SSO. Inoltre, sono disponibili integrazioni SSO personalizzate, purché rispettino lo standard SAML 2.0.
Protocollo: SAML 2.0+
Documentazione: Panoramica del SSO di Udemy Business e delle sue funzioni principali
API SCIM per il provisioning degli utenti - Il provisioning SCIM (System for Cross-domain Identity Management) consente di effettuare il provisioning e il deprovisioning delle licenze degli utenti. Questo sistema consente ai team IT o alle integrazioni personalizzate di automatizzare le funzioni di gestione delle licenze.
Protocollo: SCIM
Documentazione: Provisioning SCIM (System for Cross-domain Identity Management)
API legacy dei corsi
API dei corsi - protocollo: RESTful
- L'API dei corsi segue le tradizionali norme EdTech. Ottiene tutti i metadati dei corsi per un singolo corso o per tutti i corsi.
Nota bene: trattandosi di un'API legacy, non rilasceremo alcuna nuova funzionalità per questa API dei corsi. Tutte le nuove funzionalità saranno rilasciate per le API GraphQL che, oltre ai corsi, includono tutti gli strumenti di apprendimento.
Documentazione: documentazione API Udemy Business - API RESTful
Migliore integrazione consigliata
Ogni cliente e partner di Udemy è differente e può avere esigenze diverse. Per ottenere la migliore integrazione possibile, consigliamo di incorporare le seguenti API:
1. Corsi e strumenti di apprendimento: utilizza l'API GraphQL per avere accesso a tutti gli strumenti di apprendimento
2. Reportistica: utilizza l'API REST per avere accesso all'intera gamma di dati e completala con l'xAPI per i dati in tempo reale
3. SSO: consigliamo l'utilizzo insieme a SCIM per automatizzare il provisioning e il deprovisioning degli utenti
4. Percorsi di apprendimento: utilizza l'API dei percorsi di apprendimento per consentire agli amministratori L&D e ai responsabili dei programmi di creare percorsi di apprendimento per l'utente finale.
-
Casi di utilizzo di integrazione dei partner
Leggi l'articoloUdemy Business: apprendere per vivere meglio
Accedi al motore di apprendimento di Udemy e distribuisci contenuti di sviluppo professionale attraverso le tue reti di contatti e i tuoi ecosistemi grazie alle soluzioni di connettività e alle migliori versioni delle app, che coinvolgono gli utenti con le tue piattaforme e i tuoi servizi online e i servizi di apprendimento di Udemy.
Udemy Business offre migliaia di corsi creati e aggiornati alla velocità dei cambiamenti del mercato (cioè il Motore di apprendimento). Dal coding alle competenze aziendali, dallo sviluppo personale a molto altro ancora, Udemy offre corsi online di alta qualità e molto richiesti che aiutano gli individui a raggiungere i propri obiettivi professionali e di business.
Grazie a un'integrazione specifica con Udemy Business, i tuoi servizi offriranno agli utenti la ricerca e la scoperta dei corsi Udemy Business (e dei percorsi di apprendimento) più votati in modo nativo dalla tua piattaforma, con la possibilità di accedere a un sito Udemy Business dedicato per un'esperienza completa dei corsi.
Sommario:
Caso di utilizzo 1: integrazione dei contenuti
Caso d'utilizzo 2: progressi degli utenti e relative statistiche
Tempistiche e tappe dell'integrazione
Architettura di riferimento di insieme
L'integrazione di Udemy Business abilita i due principali casi di utilizzo:
Caso di utilizzo 1: integrazione dei contenuti
Le integrazioni di contenuti estendono l'accesso all'apprendimento online di Udemy Business (cioè ai corsi e ai percorsi di apprendimento) e amplificano le tue offerte principali di servizi online. Con l'integrazione dei contenuti di Udemy Business, i partner possono offrire un accesso semplice da cercare e scoprire ai corsi online e ai percorsi di apprendimento di Udemy Business (obiettivi di apprendimento strutturati) direttamente sul web nativo del partner e/o sulle app mobili native. I tuoi utenti scopriranno e utilizzeranno i consigliati di Udemy (o i percorsi di apprendimento) in un'esperienza nativa e familiare. I contenuti integrati di Udemy Business avvantaggiano gli utenti (e i partner) offrendo un'interfaccia di coinvolgimento semplice da utilizzare con il sito e i servizi dei partner. L'integrazione dei contenuti avviene tramite moderni servizi web (cioè API) che si collegano a un potente motore di apprendimento online. Udemy supporta i partner attraverso l'ambito e la progettazione del connettore di integrazione dei contenuti, compresa la guida alla creazione, al test, alla distribuzione e alla gestione del ciclo di vita del connettore a sostegno dell'esperienza nativa dell'app web (o mobile) dei partner.
Benefici principali:
- Accedi ai più recenti contenuti di apprendimento online per lo sviluppo professionale e personale direttamente dal tuo sito web e dalle app mobili native.
- Aumenta il coinvolgimento con i contenuti attuali grazie a una sincronizzazione veloce e automatica.
- Naviga facilmente tra i contenuti grazie a un'esperienza di ricerca e scoperta intuitiva.
- Monitora i progressi dell'apprendimento in tempo reale e supporta lo sviluppo dei dipendenti.
- Accesso facile e sicuro grazie ai servizi di single sign on (SSO).
- Porta l'apprendimento nel tuo sistema mobile nativo e nella tua app mobile per un'esperienza di apprendimento che non si ferma mai.
Caso d'utilizzo 2: progressi degli utenti e relative statistiche
Scopri le esigenze di apprendimento dei tuoi utenti integrando i dati degli studenti di Udemy Business. Incorporando il coinvolgimento, i progressi e i completamenti dei corsi degli utenti nei tuoi dati analitici, puoi personalizzare e sviluppare continuamente esperienze guidate che tengano conto delle esigenze individuali e dei concetti chiave (ad esempio, percorsi di apprendimento creati ad hoc). Analisi dell'apprendimento sfrutta un ricco set di dati di segnali di coinvolgimento degli utenti, consentendo ai nostri partner di costruire modelli di apprendimento compositi dei loro utenti attraverso set di dati unici per migliorare continuamente l'esperienza di apprendimento degli utenti.
Benefici principali:
- Sviluppa analisi di apprendimento composite per scoprire i segnali chiave delle esigenze di apprendimento dei tuoi utenti.
- Utilizza le informazioni sull'apprendimento per adattare i contenuti di Udemy Business al tuo pubblico.
- Amplifica la tua offerta di servizi con l'intelligenza artificiale per identificare le esigenze e gli interessi unici dei tuoi utenti.
- Misurare e sviluppare continuamente un'esperienza di apprendimento completa che promuova un'esperienza di apprendimento olistica e un'assistenza integrata.
Costruito con Udemy Business Services e il potente motore di apprendimento Udemy, esplora l'ecosistema dei partner Udemy.
Tempistiche e tappe dell'integrazione
In media, i partner impiegano 4 settimane per la progettazione, lo sviluppo e l'implementazione di un connettore basato su API a supporto dei casi d'utilizzo sopra descritti. Udemy Business dedica un Partner Lead e un Solution Engineer durante il progetto di sviluppo del connettore per guidare e consigliare i partner sulle buone pratiche per ottimizzare l'integrazione con le API di Udemy.
Architettura di riferimento di insieme
I componenti di base dell'integrazione sono illustrati di seguito. La sincronizzazione dei dati è gestita dalle API di Udemy Business e orchestrata dal connettore costruito dai partner. La ricerca e il reperimento dei corsi e dei percorsi di apprendimento di Udemy sono abilitati tramite il connettore direttamente sulle applicazioni web e mobile native dei partner.
Con il single sign-on opzionale, gli utenti sono collegati senza problemi a un sito Udemy Business direttamente dalla piattaforma di apprendimento dei partner.
-
Passaggi di integrazione per i partner tecnologici
Leggi l'articoloUna guida rapida per l'integrazione
Vogliamo che la tua integrazione venga avviata rapidamente, in modo da permettere a entrambi di aprire nuovi mercati per i nostri clienti comuni.
Di seguito è riportata la pagina Integrazioni di Udemy Business.
Passaggi prerequisiti
- Domanda di partnership presentata e approvata
- Udemy fornisce un ambiente sandbox per Udemy Business
- L'amministratore Udemy invita utenti aggiuntivi
Se manca uno di questi elementi, consulta la (Guida introduttiva) per poterli completare.
Casi di utilizzo dell'integrazione dei partner: se vuoi rivedere i casi d'utilizzo d'insieme supportati da queste fasi di integrazione. In caso contrario, passiamo allo sviluppo.
Passaggi di sviluppo
La nostra buona pratica consigliata è quella di mitigare il rischio tecnico, connettendosi prima a tutte le API di Udemy, per poi iniziare lo sviluppo del software dopo aver confermato il funzionamento di tutti gli endpoint.
- Connettiti all'API Corsi, sposta almeno 10 corsi
- Connettiti all'API Corsi, sposta 1 corso
- Accedi al sito di Udemy Business e iscriviti a un corso, guarda una lezione per almeno 1 minuto (puoi aumentare la velocità di riproduzione)
- Connettiti all'API di reportistica (utente-attività)
- Connettiti all'API di reportistica (utente-corso-attività)
- Connettiti all'API di reportistica (apprendimento-attività-tentativo)
- Accedi al tuo sito Udemy Business e crea un Percorso di apprendimento (documentazione), apri un corso e aggiungilo al percorso di apprendimento appena creato.
- Connettiti all'API del percorso di apprendimento, sposta il percorso di apprendimento che hai creato.
Configurazioni
Se la maggior parte delle API funziona correttamente, puoi passare alle fasi di configurazione.
- La configurazione del Single Sign On (SSO) si effettua direttamente nella pagina Impostazioni di Udemy Business. Per accedere a queste impostazioni è necessario disporre delle credenziali di amministratore. Configura un sistema SSO pronto per l'uso con uno dei nostri numerosi provider. Oppure crea una connessione personalizzata con SAML 2.0. (link alla documentazione SSO)
- Verifica il resto delle impostazioni all'interno di [Udemy Business: Manage: Settings] e personalizzale a tuo piacimento.
Miglioramenti
Percorsi di apprendimento: consente agli utenti di creare un curriculum contenente una grande varietà di risorse di apprendimento, con un inizio e una fine per guidare l'allievo.
- Accedi al tuo sito Udemy Business e crea un Percorso di apprendimento (documentazione), apri un corso e aggiungilo al percorso di apprendimento appena creato.
- Connettiti all'API del percorso di apprendimento; sposta il percorso di apprendimento che hai creato.
- Connettiti all'API di reportistica (learning-path-activity)
Reportistica in tempo reale tramite Webhook
- Configurazione di xAPI: webhook di Udemy per la segnalazione dei progressi e degli eventi di completamento degli studenti (documentazione). Dovrai aggiungere i parametri nella pagina delle impostazioni dell'amministratore di Udemy.
- Una volta completata la configurazione, guarda una breve lezione alla massima velocità di riproduzione e verifica se hai ricevuto i dati dei progressi.
Interrogare o cercare i dati dei corsi: utilizzando l'API GraphQL di Udemy, permettiamo di interrogare il nostro catalogo di corsi, restituendo solo i dati necessari per quel caso d'uso specifico. Inoltre, mettiamo a disposizione un'API di ricerca che filtra i dati inseriti e restituisce i risultati dei corsi pertinenti.
- Ottieni credenziali API GraphQL
- Chiama funzione GraphQL GetAuthToken()
- Usa [authToken] per chiamare l'API del corso
- Chiama l'API CourseSearch
Attenzione: per accedere alla documentazione GraphQL è necessario il login su Udemy Business. L'URL applicabile presenta il sottodominio dell'account Udemy dell'organizzazione seguito da .udemy.com/dev-portal/api-reference/.
Ad esempio:
https://{sottodominio}.udemy.com/dev-portal/api-reference/.
Sviluppo software di base
Con tutte le credenziali Udemy funzionanti, tutte le API collegate e le configurazioni aggiuntive impostate, il rischio tecnico è stato eliminato. La maggior parte dei partner passerà poi alla pianificazione o allo sviluppo. Un modo per iniziare è prendere un elenco di user stories o di casi di utilizzo supportati e mappare le API Udemy necessarie per ogni caso d'uso. Da qui in poi ti auguriamo buona fortuna con il lavoro di ingegneria del software!
Gestione degli errori, eccezioni e buone pratiche
Proteggi il tuo software incorporando la gestione degli errori, delle eccezioni e dei casi limite. Per gestire i problemi informatici imprevisti, abbiamo una serie di consigli in merito alla gestione degli errori.
- Registra le risposte di errore restituite dalle API
- Aggiungi una logica di riprova alle chiamate API
- Gestisci i limiti massimi usando le migliori pratiche di page_size
- Implementa altre buone pratiche contenute nel documento
Per ulteriore assistenza, feedback o al completamento della nuova integrazione, contattaci all'indirizzo partnersupport@udemy.com. Non vediamo l'ora di aprire nuovi mercati insieme grazie alla nostra nuova funzionalità reciproca.
-
Documentazione e guide al supporto
Leggi l'articoloI partner tecnologici di Udemy Business sfruttano le API della piattaforma per consentire la sincronizzazione automatica della raccolta di contenuti UB e dei dati sulle attività degli studenti nella piattaforma dei partner. Le integrazioni sono disponibili solo per i clienti comuni. Preparati a creare un'integrazione con Udemy Business. Ecco la documentazione necessaria per iniziare.
-
Casi di utilizzo e buone pratiche per l'uso delle API Web di Udemy Business
Leggi l'articoloCon le API Web di Udemy Business (REST/GraphQL/xAPI), puoi collegare facilmente i tuoi strumenti amministratore, la piattaforma LMS e le suite HR con il catalogo dei corsi di Udemy (tramite metadati) e i dati di coinvolgimento degli studenti.
Promuovi l'apprendimento sul posto di lavoro attraverso:
- La sincronizzazione automatica dei dati degli utenti tra Udemy Business e la tua directory dei dipendenti (ad es. Okta, Azure)
- La ricerca, la scoperta e la pubblicazione di lezioni e corsi Udemy Business integrati nei tuoi sistemi HR
- L'analisi del coinvolgimento nei corsi in tempo reale per la tua organizzazione direttamente dalle tue app
Nota: la guida riportata di seguito è stata pubblicata nel Centro di supporto di Udemy Business.
Scopri di più: Casi di utilizzo e buone pratiche per l'uso delle API Web di Udemy Business
Documentazione e guide di supporto
-
Riepilogo delle API disponibili
Leggi l'articolo -
Casi di utilizzo di integrazione dei partner
Leggi l'articolo -
Passaggi di integrazione per i partner tecnologici
Leggi l'articolo -
Documentazione e guide al supporto
Leggi l'articolo -
Casi di utilizzo e buone pratiche per l'uso delle API Web di Udemy Business
Leggi l'articolo