Συνήθεις ερωτήσεις για το 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 στο σύστημα παραγωγής σας, θα πρέπει να το γνωρίζετε και να έχετε τη δυνατότητα να το χειρίζεται το σύστημά σας.

Ε: Ακολούθησα μια σύνδεση με σελιδοδείκτες στο περιεχόμενο, αλλά τώρα μου δείχνει ένα διαφορετικό τμήμα περιεχομένου από αυτό που περίμενα. Γιατί;

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

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

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

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

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

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

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

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

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

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

Άλλο

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

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

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

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

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