Del via

Ofte stillede spørgsmål om Microsoft Learn Catalog API

  • Artikel

I denne artikel beskrives ofte stillede spørgsmål om Microsoft Learn Catalog-API'en med deres svar og links til flere oplysninger efter behov.

Generel

Spørgsmål: Hvor meget koster det at bruge Learn Catalog-API'en?

Der er ingen omkostninger ved at bruge Api'en til Læringskatalog. Du kan finde flere oplysninger i afsnittet Tilgængelighed og prisfastsættelse i artiklen oversigt over funktionsoversigten Learn Catalog API.

Spørgsmål: Hvad er reglerne for brug af Learn Catalog-API'en?

Se Microsoft Learn- og vilkår for anvendelse af Microsoft API.

spørgsmål: Skal jeg onboarde eller hente nøgler for at bruge Learn Catalog-API'en?

Nej. API'en er offentligt tilgængelig. Se artiklen Introduktion til API'en til Learn-katalog ved hjælp af cURL og Visual Studio Code og/eller artiklen Learn Catalog API Developer Reference.

spørgsmål: Vil denne API lade vores brugere bruge Learn-indholdet på vores platform?

Nej. Learn Catalog-API'en indeholder metadata om indholdet og direkte links til indholdet. Brugerne kan integrere disse links i en hvilken som helst LMS (Learning Management System) eller weboplevelse i henhold til Vilkår for anvendelse af Microsoft API.

spørgsmål: Forbliver de data, der returneres fra Api'en til Learn-kataloget, statiske eller ændres?

Dataene ændres, hver gang nyt indhold tilføjes, ændres eller slettes, hvilket normalt sker dagligt.

API-svar

Spørgsmål: Kan jeg hente alle dataene på én gang?

Ja. Brug basisslutpunktet, learn.microsoft.com/api/catalog for at få det fulde svar. Se artiklen Learn Catalog API Developer Reference for at få flere oplysninger om API-anmodninger.

Spørgsmål: Kan jeg filtrere svaret på forhånd?

Ja. Se de forespørgselsfiltre, der er tilgængelige i artiklen Learn Catalog API Developer Reference.

Spørgsmål: Er UID'erne entydige for hvert indholdsobjekt?

Ja. UID står for "Entydigt id" og er entydigt for hvert indholdsobjekt. Hvis et UID ændres, selvom titlen eller andre metadata forbliver det samme, betragtes indholdet som et nyt objekt.

Spørgsmål: Hvorfor er der HTML-koder i oversigten over modulet?

Vi forsøger typisk at bevare formateringen af oversigten så rå som muligt, men nogle gange er vi nødt til at fremhæve eller sammenkæde en bestemt tekst.

Spørgsmål: Hvorfor er der ikke links til de enkelte enheder?

Enhederne skrives ikke som separat indhold. De er beregnet til at blive taget i en bestemt rækkefølge for modulet. Derfor inkluderer vi linket til siden med moduldetaljer og det første undermodul, så brugerne kan starte der og fortsætte gennem indholdet.

Spørgsmål: Hvordan kan jeg se, hvilket indhold der er nyt?

Værdien last_modified fortæller dig, hvornår posten sidst blev ændret.

Spørgsmål: Er enkelt Sign-On (SSO) aktiveret for indholdslinkene?

Ikke på nuværende tidspunkt. Vi sigter mod at aktivere SSO i fremtiden.

Indhold

Spørgsmål: Er UID'et entydigt for indhold?

Ja. UID står for "Entydigt id" og er entydigt for hvert indholdsobjekt. Hvis et UID ændres, selvom titlen eller andre metadata forbliver det samme, betragtes indholdet som et nyt objekt.

Spørgsmål: Er alle moduler en del af et læringsforløb?

Nej. Moduler er alle i stand til at stå alene i den forstand, at de underviser i et scenarie eller et koncept fra start til slut i dem og ikke kræver, at de tager forudsætningsmoduler. For nogle er det det, og de er ikke en del af et læringsforløb. For andre er de samlet i et eller flere læringsforløb, der fører en bruger gennem opbygning af mere avancerede begreber. Et modul behøver ikke at være en del af et læringsforløb, eller det kan være en del af et eller flere.

Spørgsmål: Hvordan ved jeg, hvornår indhold er blevet tilføjet, opdateret eller slettet?

Når der tilføjes nye indholdsobjekter, vises de som et nyt objekt (identificeret af UID) i svaret. Når indhold ændres, kan du se det på baggrund af dens last_modified værdi. Når indhold slettes, fjernes indholdsobjektet fra svaret. Selvom der nogle gange er en lille forsinkelse i indhold, der opdateres i API-svaret, når en bruger følger URL-adressen til indholdet, får vedkommende altid vist de mest aktuelle oplysninger. Når indhold slettes, omdirigerer den gamle URL-adresse til det nye indhold eller den nye oplevelse eller til den næste bedste mulighed.

Især opdateres indhold hele tiden. Vi publicerer tilgængelige opdateringer to gange om dagen. De kan enten være mindre, f.eks. mindre tekstændringer eller større, f.eks. større ændringer, tilføjelser eller sletninger. Indholdsporteføljen administreres generelt som et massivt, højt styret projekt med åben kildekode med tusindvis af bidragydere, og som sådan sker der ændringer hele tiden. Hvis du bruger Learn Catalog-API'en i dit produktionssystem, skal du være opmærksom på dette og have dit system i stand til at håndtere det.

Spørgsmål: Jeg har fulgt et link med bogmærker til indhold, men nu viser det mig et andet indhold, end jeg havde forventet. Hvorfor?

Vi bestræber os på at sikre, at ingen rammer en blindgyde (404) med links til vores hjemmeside. Når indhold ændres eller erstattes, implementerer vi en omdirigering for det gamle link, der automatisk fører dig til det nye indhold. I tilfælde af at indhold frarådes og ikke erstattes af forskellige årsager, omdirigerer vi til det næste bedst egnede indhold, som kan være et lidt ændret omfang, eller til en landingsside osv.

Spørgsmål: Hvordan får jeg adgang til dokumentation, video og kodeeksempelkataloger?

Der er ingen programmeringsmæssig måde at få adgang til disse kataloger på i øjeblikket. Vi sigter mod at give programmatisk adgang til disse kataloger i fremtiden.

Lokalisering

Spørgsmål: Hvilke sprog er tilgængelige i Microsoft Learn?

Der er mere end 65 landestandarder tilgængelige i Microsoft Learn. Du kan se en komplet liste her via webstedsfoden (vælg det sprog, du får vist for at se hele listen).

Spørgsmål: Er indholdet tilgængeligt på andre sprog?

Det afhænger af. Vi sigter mod at gøre indholdet tilgængeligt på alle de sprog, som de produkter, der undervises i indholdet, er tilgængelige på. Når eleverne besøger Microsoft Learn-webstedet i en bestemt landestandard, og indholdet ikke er tilgængeligt i den pågældende landestandard, får brugeren vist sidehovedet og sidefoden i den ønskede landestandard, og kerneindholdet skifter tilbage til engelsk, indtil der er en lokaliseret version tilgængelig.

Spørgsmål: Er indholdet forskelligt for et bestemt indholdsobjekt, afhængigt af hvilket sprog du får det vist på?

Måske. Når der publiceres opdateringer til det engelske indhold, arbejder vores lokaliseringspipelines på at få de oversatte versioner opdateret så hurtigt som muligt – normalt inden for et par dage efter den oprindelige ændring.

Anden

Spørgsmål: Er der nogen rapporterings-API eller -funktionalitet til at hente data som visninger, klik, fuldførelse?

Vi har ikke en rapporterings-API på nuværende tidspunkt. Vi har funktioner til organisationsrapportering, der gør det muligt for organisationer at rapportere om deres brugeres fuldførelse.

Næste trin

Du kan få mere at vide om Learn Catalog-API'en ved at gå til følgende links: