הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
מאמר זה מפרט שאלות נפוצות אודות ה- API של Microsoft Learn Catalog, עם התשובות והקישורים שלו למידע נוסף לפי הצורך.
כללי
ש: כמה עולה השימוש ב- API של קטלוג Learn?
אין עלות לשימוש ב- API של קטלוג Learn. לקבלת מידע נוסף, עיין בסעיף זמינות ותמחור במאמר מבט כולל על API של קטלוג למד על.
ש: אילו כללים יש להשתמש ב- API של Learn Catalog?
ראה את השימוש של Microsoft Learn ותנאי השימוש ב- API של Microsoft.
ש: האם עליי להוסיף או לקבל מפתחות כדי להשתמש ב- API של קטלוג Learn?
לא. ה- API זמין באופן ציבורי. עיין במאמר תחילת העבודה עם ה- API של Learn Catalog באמצעות cURL ו- Visual Studio Code ו/או במאמר Learn Catalog API Developer Reference.
ש: האם API זה יאפשר למשתמשים שלנו לצרוך את התוכן של Learn בתוך הפלטפורמה שלנו?
לא. ה- API של קטלוג Learn מספק מטה-נתונים אודות התוכן וקישורים ישירים לתוכן. המשתמשים יכולים לשלב קישורים אלה בכל מערכת ניהול למידה (LMS) או חוויית אינטרנט בהתאם לתנאי השימוש ב- API של Microsoft .
Q: האם הנתונים המוחזרים מ- API של קטלוג Learn נשארים סטטיים או משתנים?
הנתונים משתנים בכל פעם שתוכן חדש נוסף, משתנה או נמחק, שהוא בדרך כלל על בסיס יומי.
תגובת API
ש: האם ניתן ללכוד את כל הנתונים בבת אחת?
כן. השתמש בנקודות הקצה learn.microsoft.com/api/catalog כדי לקבל את התגובה המלאה. עיין במאמר למפתחי API של Learn Catalog לקבלת מידע נוסף אודות בקשת API.
ש: האם ניתן לסנן מראש את התגובה?
כן. עיין במסנני השאילתה הזמינים במאמר מדריך למפתחי API Learn Catalog API ב-.
ש: האם ממשקי המשתמש ייחודיים עבור כל אובייקט תוכן?
כן. UID פירושו "מזהה ייחודי" והוא ייחודי עבור כל אובייקט תוכן. אם מזהה ייחודי (UID) משתנה, גם אם הכותרת או מטה-נתונים אחרים נשארים זהים, התוכן נחשב לאובייקט חדש.
ש: מדוע יש תגי HTML בסיכום המודול?
אנחנו בדרך כלל מנסים לשמור על עיצוב הסיכום גולמי ככל האפשר, אך לפעמים עלינו להדגיש או לקשר טקסט מסוים.
ש: מדוע אין קישורים עבור היחידות הבודדות?
היחידות אינן נכתבות כתוכן עצמאי. הם נועדו להילקח בסדר מסוים עבור המודול. מסיבה זו, נכלול את הקישור לדף פרטי המודול ואת היחידה הראשונה כדי שהמשתמשים יוכלו להתחיל שם ולהמשיך בתוכן.
ש: כיצד אוכל לדעת איזה תוכן חדש?
ערך last_modified מציין מתי הרשומה שונתה לאחרונה.
ש: האם אפשרות Sign-On בודדת (SSO) זמינה עבור קישורי התוכן?
לא בשלב זה. אנו שואפים להפוך SSO לזמין בעתיד.
תוכן
ש: האם ה- UID ייחודי לתוכן?
כן. UID פירושו "מזהה ייחודי" והוא ייחודי עבור כל אובייקט תוכן. אם מזהה ייחודי (UID) משתנה, גם אם הכותרת או מטה-נתונים אחרים נשארים זהים, התוכן נחשב לאובייקט חדש.
ש: האם כל המודולים הם חלק מנתיב למידה?
לא. כל המודולים מסוגלים לעמוד לבד, באופן שהם מלמדים תרחיש או רעיון מקצה לקצה בתוכם ואינם דורשים שימוש במודולים המהווים דרישה מוקדמת. עבור חלק מהמשתמשים, זהו זה והם אינם חלק מנתיב למידה. עבור אנשים אחרים, הם כרוכים יחד בנתיב למידה אחד או יותר, המקיימים משתמש על-ידי בניית מושגים מתקדמים יותר. מודול אינו חייב להיות חלק מנתיב למידה, או שהוא יכול להיות חלק מנתיב אחד או יותר.
ש: כיצד אוכל לדעת מתי התוכן נוסף, עבר רענון או נמחק?
בעת הוספת אובייקטי תוכן חדשים, הם מופיעים אובייקט חדש (המזוהה על-ידי UID) בתגובה. בעת שינוי תוכן, באפשרותך לדעת בהתבסס על הערך last_modified שלו. בעת מחיקת תוכן, אובייקט התוכן מוסר מהתגובה. למרות שלפעמים יש עיכוב קל בתוכן המתעדכן בתגובה ל- API, כאשר משתמש עוקב אחר כתובת ה- URL לתוכן, הוא תמיד רואה את המידע העדכני ביותר. בעת מחיקת תוכן, כתובת ה- URL הישנה תנתב מחדש לתוכן או לחוויה החדשה, או אל האפשרות הטובה ביותר הבאה.
עם זאת, התוכן מתעדכן כל הזמן. אנו מפרסמים עדכונים זמינים פעמיים ביום. הם עשויים להיות משניים, כגון שינויי טקסט משניים, או ראשיים, כגון תיקונים עיקריים, תוספות או מחיקות. באופן כללי, תיק התוכן מנוהל כפרוייקט מקור פתוח עצום, תחת פיקוח רב, עם אלפי משתתפים, ובפיו שינויים מתרחשים כל הזמן. אם אתה משתמש ב- API של קטלוג Learn במערכת הייצור שלך, עליך להיות מודע לכך ולהוות את המערכת שלך מסוגל לטפל בה.
ש: הפעלתי קישור המסומן בסימניה לתוכן, אך כעת מוצג לי פריט תוכן שונה מכפי שצפוי. למה?
אנו שואפים להבטיח שלא יגיע למ מבוי סתום (404) עם קישורים לאתר שלנו. כאשר תוכן משתנה או מוחלף, אנו מיישמים ניתוב מחדש עבור הקישור הישן שינתב אותך באופן אוטומטי לתוכן החדש. במקרה שבו התוכן יצא משימוש ולא יוחלף מסיבות שונות, ננתב מחדש לתוכן המתאים הבא, שעשוי להיות טווח שהשתנה במקצת, או לדף נחיתה וכו'.
ש: כיצד ניתן לקבל גישה לקטלוגים לדוגמה של תיעוד, וידאו וקוד?
אין דרך תיכנותית בשלב זה לקבל גישה לקטלוגים אלה. אנו שואפים לאפשר גישה תוכניתית לקטלוגים אלה בעתיד.
לוקליזציה
ש: אילו שפות זמינות ב- Microsoft Learn?
יש יותר מ- 65 אזורים זמינים ב- Microsoft Learn. באפשרותך לראות רשימה מלאה כאן דרך הכותרת התחתונה של האתר (בחר את השפה שאתה מציג כדי לראות את הרשימה המלאה).
ש: האם התוכן זמין בשפות אחרות?
זה תלוי . אנו שואפים להפוך את התוכן לזמין בכל השפות שבהם המוצרים הנלמדים בתוכן זמינים. כאשר לומדים מבקרים באתר Microsoft Learn באזור נתון, אם התוכן אינו זמין באזור זה, המשתמש רואה את הכותרת העליונה והכותרת התחתונה באזור הרצוי, וברירת המחדל של תוכן הליבה חוזרת לאנגלית עד שגירסה מותאמת לשפות אחרות תהיה זמינה.
ש: האם התוכן שונה עבור אובייקט תוכן נתון, בהתאם לשפה שבה אתה להציג אותו?
אולי. כאשר עדכונים מתפרסמים בתוכן באנגלית, קווי הצינור של ההתאמה לשפות אחרות פועלים כדי לעדכן את הגירסאות המותאמות לשפות אחרות בהקדם האפשרי – בדרך כלל תוך כמה ימים מהשינוי המקורי.
אחר
ש: האם יש API או פונקציונליות של דיווח כדי לקבל נתונים כגון תצוגות, לחיצות, השלמה?
אין לנו API לדיווח בשלב זה. יש לנו פונקציונליות דיווח ארגונית לאפשר לארגונים לדווח על ההשלמה של המשתמשים שלהם.
השלבים הבאים
תוכל לקבל מידע נוסף על ה- API של קטלוג Learn על-ידי ביקור בקישורים הבאים: