Συνήθεις ερωτήσεις για το Microsoft Learn Catalog API

Αυτό το άρθρο παραθέτει τις συνήθεις ερωτήσεις σχετικά με το API Microsoft Learn Catalog, με τις απαντήσεις και τις συνδέσεις τους σε περισσότερες πληροφορίες, ανάλογα με τις ανάγκες.

Γενικός

Ε: Πόσο κοστίζει η χρήση του API Learn Catalog;

Δεν υπάρχει κόστος για τη χρήση του API Learn Catalog. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα Διαθεσιμότητα και τιμολόγηση του άρθρου Επισκόπηση δυνατοτήτων API Learn Catalog.

Ε: Ποιοι είναι οι κανόνες για τη χρήση του API Learn Catalog;

Ανατρέξτε στους Όρους χρήσης του Microsoft Learn και του Microsoft API.

Ε: Χρειάζεται να καταχωρήσω ή να αποκτήσω κλειδιά για να χρησιμοποιήσω το API Learn Catalog;

Όχι. Το API είναι διαθέσιμο στο κοινό. Ανατρέξτε στο άρθρο Γρήγορα αποτελέσματα με το API Learn Catalog με χρήση cURL και κώδικα Visual Studio ή/και στο άρθρο Αναφορά προγραμματιστών του Learn Catalog API.

Ε: Θα επιτρέψει αυτό το API στους χρήστες μας να χρησιμοποιήσουν το περιεχόμενο Learn στην πλατφόρμα μας;

Όχι. Το API Learn Catalog παρέχει μετα-δεδομένα σχετικά με το περιεχόμενο και άμεσες συνδέσεις προς το περιεχόμενο. Οι χρήστες μπορούν να ενσωματώνουν αυτές τις συνδέσεις σε οποιαδήποτε εμπειρία LMS ή web σύμφωνα με τους Όρους χρήσης του Microsoft API.

Ε: Τα δεδομένα που επιστρέφονται από το API Learn Catalog παραμένουν στατικά ή αλλάζουν;

Τα δεδομένα αλλάζουν κάθε φορά που προστίθεται, τροποποιείται ή διαγράφεται νέο περιεχόμενο, το οποίο συνήθως γίνεται σε καθημερινή βάση.

Απόκριση API

Ε: Μπορώ να ανακτήσω όλα τα δεδομένα ταυτόχρονα;

Ναι. Χρησιμοποιήστε το βασικό τελικό σημείο, learn.microsoft.com/api/catalog για να λάβετε την πλήρη απόκριση. Ανατρέξτε στο άρθρο Αναφορά προγραμματιστών του Learn Catalog για περισσότερες πληροφορίες αίτησης API.

Ε: Μπορώ να φιλτράρω εκ των προτέρων την απόκριση;

Ναι. Ανατρέξτε στα φίλτρα ερωτημάτων που είναι διαθέσιμα στο άρθρο Αναφορά προγραμματιστών API Learn Catalog.

Ε: Είναι τα περιβάλλοντα εργασίας χρήστη μοναδικά για κάθε αντικείμενο περιεχομένου;

Ναι. Το UID σημαίνει "Μοναδικό αναγνωριστικό" και είναι μοναδικό για κάθε αντικείμενο περιεχομένου. Εάν αλλάξει ένα UID, ακόμα και αν ο τίτλος ή άλλα μετα-δεδομένα παραμείνουν τα ίδια, το περιεχόμενο θεωρείται νέο αντικείμενο.

Ε: Γιατί υπάρχουν ετικέτες HTML στη σύνοψη της εκπαιδευτικής ενότητας;

Συνήθως προσπαθούμε να διατηρήσουμε τη μορφοποίηση της σύνοψης όσο το δυνατόν πιο ανεπεξέργαστα, αλλά μερικές φορές χρειάζεται να τονίσουμε ή να συνδέσουμε συγκεκριμένο κείμενο.

Ε: Γιατί δεν υπάρχουν συνδέσεις για τις μεμονωμένες μονάδες;

Οι μονάδες δεν έχουν συνταχθεί ως αυτόνομο περιεχόμενο. Προορίζονται να ληφθούν με συγκεκριμένη σειρά για την εκπαιδευτική ενότητα. Για αυτόν τον λόγο, συμπεριλαμβάνουμε τη σύνδεση στη σελίδα λεπτομερειών της εκπαιδευτικής ενότητας και το πρώτο κεφάλαιο, έτσι ώστε οι χρήστες να μπορούν να ξεκινήσουν από εκεί και να συνεχίσουν με το περιεχόμενο.

Ε: Πώς γίνεται πείτε ποιο περιεχόμενο είναι νέο;

Η τιμή last_modified θα σας ενημερώσει πότε τροποποιήθηκε τελευταία φορά η εγγραφή.

Ε: Είναι ενεργοποιημένη η καθολική σύνδεση (SSO) για τις συνδέσεις περιεχομένου;

Όχι αυτή τη στιγμή. Στόχος μας είναι να ενεργοποιήσουμε το SSO στο μέλλον.

Περιεχόμενο

Ε: Το UID είναι μοναδικό για το περιεχόμενο;

Ναι. Το UID σημαίνει "Μοναδικό αναγνωριστικό" και είναι μοναδικό για κάθε αντικείμενο περιεχομένου. Εάν αλλάξει ένα UID, ακόμα και αν ο τίτλος ή άλλα μετα-δεδομένα παραμείνουν τα ίδια, το περιεχόμενο θεωρείται νέο αντικείμενο.

Ε: Αποτελούν όλες οι εκπαιδευτικές ενότητες μέρος ενός μαθησιακού διαύλου;

Όχι. Οι εκπαιδευτικές ενότητες είναι όλες ικανές να στέκονται μόνες τους, με την έννοια ότι διδάσκουν ένα σενάριο ή μια έννοια από άκρο σε άκρο μέσα σε αυτές και δεν απαιτούν τη λήψη προαπαιτούμενων εκπαιδευτικών ενοτήτων. Για ορισμένους, πρόκειται για αυτό και δεν αποτελούν μέρος ενός μαθησιακού διαύλου. Για άλλους, συνδυάζονται σε έναν ή περισσότερους μαθησιακούς διαύλους που καθοδηγούν έναν χρήστη στη δημιουργία πιο προηγμένων εννοιών. Μια εκπαιδευτική ενότητα δεν χρειάζεται να αποτελεί μέρος ενός μαθησιακού διαύλου ή μπορεί να αποτελεί μέρος μίας ή περισσότερων.

Ε: Πώς γίνεται γνωρίζετε πότε έχει προστεθεί, ανανεωθεί ή διαγραφεί περιεχόμενο;

Όταν προστίθενται νέα αντικείμενα περιεχομένου, θα εμφανίζονται ως νέο αντικείμενο (αναγνωρίζεται από το UID) στην απόκριση. Όταν τροποποιείται το περιεχόμενο, μπορείτε να διακριτό στοιχείο με βάση την τιμή last_modified του. Όταν διαγραφεί το περιεχόμενο, θα καταργηθεί από την απόκριση. Παρόλο που μερικές φορές υπάρχει μια μικρή καθυστέρηση στην ενημέρωση του περιεχομένου στην απόκριση API, όταν ένας χρήστης ακολουθεί τη διεύθυνση URL για το περιεχόμενο, θα βλέπει πάντα τις πιο πρόσφατες πληροφορίες. Εάν διαγραφεί το περιεχόμενο, η παλιά διεύθυνση URL θα ανακατευθυνθεί στο νέο περιεχόμενο ή την εμπειρία.

Συγκεκριμένα, το περιεχόμενο ενημερώνεται διαρκώς. Δημοσιεύουμε ενημερώσεις συνήθως δύο φορές την ημέρα. Μπορεί να είναι δευτερεύουσες, όπως μικρές αλλαγές κειμένου ή σημαντικές, όπως σημαντικές αναθεωρήσεις, προσθήκες ή διαγραφές. Σε γενικές γραμμές, η διαχείριση του χαρτοφυλακίου περιεχομένου γίνεται ως ένα τεράστιο, εξαιρετικά διαχειρισμένο έργο ανοιχτού κώδικα με χιλιάδες συνεισφέροντες και, ως εκ τούτου, αλλαγές συμβαίνουν όλη την ώρα. Εάν χρησιμοποιείτε το API Learn Catalog στο σύστημα παραγωγής σας, θα πρέπει να γνωρίζετε πώς λειτουργεί η διαχείριση εκδόσεων περιεχομένου και να έχετε τη δυνατότητα να τη χειρίζεται το σύστημά σας.

Ε: Πώς γίνεται αποκτήσετε πρόσβαση στους καταλόγους δειγμάτων τεκμηρίωσης, βίντεο και κώδικα;

Αυτή τη στιγμή δεν υπάρχει προγραμματισμός για να αποκτήσετε πρόσβαση σε αυτούς τους καταλόγους. Στόχος μας είναι να ενεργοποιήσουμε μελλοντικά την πρόσβαση μέσω προγραμματισμού σε αυτούς τους καταλόγους.

Τοπική προσαρμογή

Ε: Ποιες γλώσσες είναι διαθέσιμες στο Microsoft Learn;

Υπάρχουν περισσότερες από 65 διαθέσιμες τοπικές ρυθμίσεις στο Microsoft Learn. Μπορείτε να δείτε μια πλήρη λίστα εδώ μέσω του υποσέλιδου τοποθεσίας (επιλέξτε τη γλώσσα που βλέπετε για να δείτε την πλήρη λίστα).

Ε: Είναι το περιεχόμενο διαθέσιμο σε άλλες γλώσσες;

Εξαρτάται. Στόχος μας είναι να καταστήσουμε το περιεχόμενο διαθέσιμο σε όλες τις γλώσσες στις οποίες τα προϊόντα που διδάσκονται στο περιεχόμενο είναι διαθέσιμα. Όταν οι εκπαιδευόμενοι επισκεφτούν την τοποθεσία του Microsoft Learn σε μια δεδομένη τοπική ρύθμιση, εάν το περιεχόμενο δεν είναι διαθέσιμο σε αυτήν την τοπική ρύθμιση, ο χρήστης θα δει την κεφαλίδα και το υποσέλιδο στις επιθυμητές τοπικές ρυθμίσεις και το βασικό περιεχόμενο θα επιστρέψει από προεπιλογή στα Αγγλικά μέχρι να είναι διαθέσιμη μια μεταφρασμένος έκδοση.

Ε: Το περιεχόμενο διαφέρει για ένα δεδομένο αντικείμενο περιεχομένου, ανάλογα με τη γλώσσα στην οποία το προβάλλετε;

Πιθανόν. Όταν δημοσιεύονται ενημερώσεις στο αγγλικό περιεχόμενο, οι διοχετεύσεις τοπικής προσαρμογής λειτουργούν ώστε οι μεταφρασμένες εκδόσεις να ενημερώνονται το συντομότερο δυνατό – συνήθως μέσα σε λίγες ημέρες από την αρχική αλλαγή.

Άλλες

Ε: Υπάρχει κάποιο API αναφοράς ή λειτουργικότητα για τη λήψη δεδομένων όπως προβολές, κλικ, ολοκλήρωση;

Δεν έχουμε API αναφορών αυτήν τη στιγμή. Έχουμε λειτουργίες εταιρικών αναφορών που επιτρέπουν στους οργανισμούς να αναφέρουν τις ολοκληρώσεις των χρηστών τους.

Επόμενα βήματα

Μπορείτε να μάθετε περισσότερα σχετικά με το API Learn Catalog, στις ακόλουθες συνδέσεις:

• Επισκόπηση δυνατοτήτων API Microsoft Learn Catalog
• Γρήγορα αποτελέσματα με το API Microsoft Learn Catalog