Condividi tramite


Domande frequenti sull'API catalogo di Microsoft Learn

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

Generale

Q: Quanto costa usare l'API del catalogo Learn?

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

D: Quali sono le regole per l'uso dell'API del catalogo di Learn?

Vedi Microsoft Learn e le Condizioni d'uso dell'API Microsoft .

D: È necessario effettuare l'onboarding o ottenere le chiavi per usare l'API del catalogo di Learn?

No. L'API è disponibile pubblicamente. Consultare l'articolo Introduzione all'API del Catalogo di Learn con cURL e Visual Studio Code e/o l'articolo Riferimento per sviluppatori dell'API del Catalogo Learn.

Q: questa API consente agli utenti di usare il contenuto Learn all'interno della piattaforma?

No. L'API Learn Catalog fornisce metadati sul contenuto e collegamenti diretti al contenuto. Gli utenti possono integrare questi collegamenti in qualsiasi esperienza Web o LMS (Learning Management System) in base alle condizioni per l'utilizzo dell'API Microsoft .

Q: I dati restituiti dall'API del Catalogo 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

D: È possibile recuperare tutti i dati contemporaneamente?

Sì. Usare l'endpoint di base learn.microsoft.com/api/catalog per ottenere la risposta completa. Per ulteriori informazioni sulle richieste API, consultare l'articolo di riferimento per sviluppatori dell'API Learn nel catalogo.

D: È possibile filtrare in modo preliminare la risposta?

Sì. Consultare i filtri di query disponibili nell'articolo di riferimento per sviluppatori dell'API del catalogo .

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.

Q: Perché sono presenti tag HTML nel riepilogo del modulo?

In genere cerchiamo di mantenere la formattazione del riepilogo il più non elaborato possibile, ma a volte dobbiamo sottolineare o collegare un determinato testo.

Q: Perché non sono presenti 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, è incluso il collegamento alla pagina dei dettagli del modulo e la prima unità in modo che gli utenti possano iniziare da lì e procedere con il contenuto.

Q: Come è possibile indicare quali contenuti sono nuovi?

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

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

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

Contenuto

Q: 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.

Q: tutti i moduli fanno parte di un percorso di apprendimento?

No. I moduli sono tutti in grado di essere autonomi, nel senso che insegnano uno scenario o un concetto in modo completo e non richiedono moduli propedeutici. Per alcuni, questo è tutto e non sono inclusi in un percorso di apprendimento. Per gli altri utenti, vengono raggruppati in uno o più percorsi di apprendimento che consentono a un utente di creare concetti più avanzati. Un modulo non deve far parte di un percorso di apprendimento o può far parte di uno o più.

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

Quando vengono aggiunti nuovi oggetti contenuto, vengono visualizzati come nuovo oggetto (identificato dall'UID) nella risposta. Quando il contenuto viene modificato, puoi capirlo in base al valore di 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 api, quando un utente segue l'URL del contenuto, visualizza sempre le informazioni più aggiornate. Quando il contenuto viene eliminato, l'URL precedente verrà reindirizzato al nuovo contenuto o esperienza o 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 altamente regolamentato, con migliaia di collaboratori, e, di conseguenza, le modifiche avvengono continuamente. 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.

Q: Ho seguito un collegamento salvato nei segnalibri al contenuto, ma mi sta mostrando un contenuto diverso rispetto a quello che mi aspettavo. Perché?

Ci impegniamo a garantire che nessuno si trovi in un vicolo cieco (404) con i collegamenti al nostro sito. Quando il contenuto viene modificato o sostituito, implementiamo un reindirizzamento per il collegamento precedente che ti 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 appropriato successivo, che può essere un ambito leggermente modificato, o a una pagina di destinazione e così via.

Q: Come si ottiene l'accesso ai cataloghi di documentazione, video ed esempi di codice?

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 in corso di insegnamento nel contenuto. Quando gli studenti visitano il sito di Microsoft Learn in una determinata impostazione locale, se il contenuto non è disponibile in tali impostazioni locali, l'utente visualizza l'intestazione e il piè di pagina nelle impostazioni locali desiderate e il contenuto principale torna all'inglese fino a quando non è disponibile una versione localizzata.

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

Forse. 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: Esiste un'API di creazione di report o funzionalità 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 dell'organizzazione che consente alle organizzazioni di generare rapporti sui completamenti degli utenti.

Passaggi successivi

Per altre informazioni sull'API Del catalogo di Learn, visitare i collegamenti seguenti: