Leggere in inglese

Condividi tramite


Domande frequenti sul Catalogo API di Microsoft Learn

Questo articolo elenca le domande frequenti sul Catalogo API di Microsoft Learn, con le relative risposte e collegamenti ad altre informazioni in base alle esigenze.

Generale

Q: Quanto costa usare il Catalogo API di Microsoft Learn?

Non è previsto alcun costo per l'uso del Catalogo API di Microsoft Learn. Per altre informazioni, vedere la sezione Disponibilità e prezzi dell'articolo Panoramica delle funzionalità Catalogo API di Microsoft Learn.

Q: Quali sono le regole per l'uso del Catalogo API di Microsoft Learn?

Vedere le Condizioni per l'utilizzo di Microsoft Learn e APIMicrosoft.

Q: È necessario eseguire l'onboarding o ottenere le chiavi per usare il Catalogo API di Microsoft Learn?

Nr. L'API è disponibile pubblicamente. Vedere l'articolo Introduzione all'API del catalogo di Learn con cURL e Visual Studio Code e/o l'articoloInformazioni di riferimento per gli sviluppatori di Catalogo API di Microsoft Learn.

D: Questa API consentirà ai nostri utenti di utilizzare contenuto di Learn all'interno della nostra piattaforma?

Nr. Il Catalogo API di Microsoft Learn fornisce metadati sul contenuto e collegamenti diretti al contenuto. Gli utenti possono integrare questi collegamenti in qualsiasi esperienza del sistema LMS (Learning Management System) o Web in base alle Condizioni per l'utilizzo dell'API Microsoft.

Q: I dati restituiti dal Catalogo API di Microsoft Learn rimangono statici o modificati?

I dati cambiano ogni volta che vengono aggiunti, modificati o eliminati nuovi contenuti, che in genere sono su base giornaliera.

Risposta API

Q: È possibile acquisire tutti i dati contemporaneamente?

Sì. Usare l'endpoint di base learn.microsoft.com/api/catalog per ottenere la risposta completa. Per altre informazioni sulla richiesta API, vedere l'articolo Informazioni di riferimento per gli sviluppatori del Catalogo API di Microsoft Learn.

Q: È possibile filtrare in modo preliminare la risposta?

Sì. Vedere i filtri di query disponibili nell'articolo Informazioni di riferimento per gli sviluppatori del Catalogo APIdi Microsoft Learn.

Q: Gli UID sono univoci per ogni oggetto contenuto?

Sì. UID è l'acronimo di "Unique ID" ed è univoco per ogni oggetto contenuto. Se un UID cambia, anche se il titolo o altri metadati rimangono invariati, il contenuto viene considerato un nuovo oggetto.

D: Per quale motivo sono presenti tag HTML nel riepilogo del modulo?

Proviamo in genere a usare formattazione il più semplice possibile per riepilogo, ma a volte è necessario sottolineare o aggiungere un collegamento per determinato testo.

D: Perché non esistono collegamenti per le singole unità?

Le unità non vengono scritte come contenuto autonomo. Devono essere eseguite in un ordine specifico per il modulo. Per questo motivo viene incluso il collegamento alla pagina dei dettagli del modulo e alla prima unità in modo che gli utenti possano iniziare da tale punto e procedere esplorando tutti i contenuti.

D: Come faccio a capire qual è il contenuto nuovo?

Il valore last_modified indica quando il record è stato modificato l'ultima volta.

Q: Single Sign-On (SSO) è abilitato per i collegamenti al contenuto?

Non al momento. L'obiettivo è abilitare l'accesso Single Sign-On in futuro.

Contenuto

D: L'UID è univoco per il contenuto?

Sì. UID è l'acronimo di "Unique ID" ed è univoco per ogni oggetto contenuto. Se un UID cambia, anche se il titolo o altri metadati rimangono invariati, il contenuto viene considerato un nuovo oggetto.

D: Tutti i moduli fanno parte di un percorso di apprendimento?

Nr. I moduli sono tutti in grado di stare da soli, nel senso che insegnano uno scenario o un concetto end-to-end all'interno di essi e non richiedono l'assunzione di moduli prerequisiti. In alcuni casi si tratta di moduli completi che non fanno parte di alcun percorso di apprendimento. In altri casi i moduli vengono aggregati in uno o più percorsi di apprendimento per consentire a un utente di acquisire concetti più avanzati. Un modulo non deve necessariamente far parte di un percorso di apprendimento oppure può far parte di uno o più percorsi.

Q: Come è possibile sapere quando il contenuto è stato aggiunto, aggiornato o eliminato?

Quando vengono aggiunti nuovi oggetti contenuto, questi verranno visualizzati come nuovo oggetto (identificato dall'UID) nella risposta. Quando il contenuto viene modificato, è possibile indicare in base al relativo valore last_modified. Quando il contenuto viene eliminato, l'oggetto contenuto viene rimosso dalla risposta. Anche se a volte si verifica un lieve ritardo nell'aggiornamento del contenuto nella risposta dell'API, quando un utente segue l'URL del contenuto vengono visualizzate sempre le informazioni più aggiornate. Quando il contenuto viene eliminato, l'URL precedente reindirizzerà al nuovo contenuto o alla nuova esperienza oppure all'opzione migliore successiva.

In particolare, il contenuto viene aggiornato sempre. Gli aggiornamenti disponibili vengono pubblicati due volte al giorno. Possono essere minori, ad esempio modifiche di testo secondarie o importanti, ad esempio revisioni, aggiunte o eliminazioni principali. In generale, il portfolio di contenuti viene gestito come un progetto open source estremamente regolamentato e altamente regolamentato con migliaia di collaboratori e, di conseguenza, le modifiche stanno accadendo sempre. Se si usa l'API Learn Catalog nel sistema di produzione, è necessario essere a conoscenza di questo e avere il sistema in grado di gestirlo.

D: Si è seguito un collegamento aggiunto ai segnalibri per il contenuto, ma viene ora visualizzato un contenuto diverso da quanto previsto. Perché?

Microsoft si impegna per garantire che non si verifichino errori di mancata visualizzazione di contenuti (404) per i collegamenti al sito. Quando il contenuto viene modificato o sostituito, viene implementato un reindirizzamento per il collegamento precedente che porterà automaticamente al nuovo contenuto. Nel caso in cui il contenuto sia deprecato e non sostituito per vari motivi, verrà eseguito il reindirizzamento al contenuto più appropriato successivo, che può avere un ambito leggermente modificato o può corrispondere a una pagina di destinazione e così via.

Q: Come si ottiene l'accesso ai record di completamento della documentazione, del video e del codice di esempio?

Al momento non esiste alcun modo a livello di codice per ottenere l'accesso a questi cataloghi. L'obiettivo è consentire l'accesso a livello di codice a questi cataloghi in futuro.

Localizzazione

Q: Quali lingue sono disponibili in Microsoft Learn?

In Microsoft Learn sono disponibili più di 65 impostazioni locali. È possibile visualizzare un elenco completo qui tramite il piè di pagina del sito (selezionare la lingua visualizzata per visualizzare l'elenco completo).

Q: Il contenuto è disponibile in altre lingue?

Dipende. Il nostro obiettivo è rendere disponibile il contenuto in tutte le lingue in cui sono disponibili i prodotti insegnati nei contenuti. Quando gli studenti visitano il sito di Microsoft Learn in determinate impostazioni locali, se il contenuto non è disponibile in tali impostazioni locali, l'utente vedrà l'intestazione e il piè di pagina nelle impostazioni locali desiderate e il contenuto principale sarà visualizzato in inglese per impostazione predefinita fino a quando non sarà disponibile una versione localizzata.

Q: Il contenuto è diverso per un determinato oggetto contenuto, a seconda della lingua in cui viene visualizzata?

È possibile. Quando gli aggiornamenti vengono pubblicati nel contenuto in lingua inglese, le pipeline di localizzazione funzionano per aggiornare le versioni localizzate il prima possibile, in genere entro pochi giorni dalla modifica originale.

Altro

Q: È disponibile un'API o una funzionalità per la creazione di report per ottenere dati quali visualizzazioni, clic, completamento?

Al momento non è disponibile un'API per la creazione di report. Sono disponibili funzionalità di creazione di report aziendali che consentono alle organizzazioni di segnalare i completamenti degli utenti.

Passaggi successivi

Per altre informazioni sul Catalogo API di Microsoft Learn, visitare i collegamenti seguenti: