الأسئلة المتداولة حول واجهة برمجة تطبيقات كتالوج Microsoft Learn
تسرد هذه المقالة الأسئلة المتداولة حول واجهة برمجة تطبيقات كتالوج Microsoft Learn، مع إجاباتها وارتباطاتها لمزيد من المعلومات حسب الحاجة.
عام
س: ما تكلفة استخدام واجهة برمجة تطبيقات كتالوج Learn؟
لا توجد تكلفة لاستخدام واجهة برمجة تطبيقات كتالوج Learn. لمزيد من المعلومات، راجع قسم التوفر والتسعير في مقالة نظرة عامة على ميزة واجهة برمجة تطبيقات كتالوج Learn.
س: ما هي قواعد استخدام واجهة برمجة تطبيقات كتالوج Learn؟
راجع شروط استخدام Microsoft Learn وMicrosoft API.
س: هل أحتاج إلى إلحاق أو الحصول على مفاتيح لاستخدام واجهة برمجة تطبيقات كتالوج Learn؟
لا. واجهة برمجة التطبيقات متاحة للجمهور. راجع مقالة بدء استخدام واجهة برمجة تطبيقات كتالوج Learn باستخدام cURL وVisual Studio Code و/أو مقالة مرجع مطور واجهة برمجة تطبيقات كتالوج Learn.
س: هل ستتيح واجهة برمجة التطبيقات هذه لمستخدمينا استخدام محتوى Learn داخل نظامنا الأساسي؟
لا. توفر واجهة برمجة تطبيقات كتالوج Learn بيانات تعريف حول المحتوى، وارتباطات مباشرة إلى المحتوى. يمكن للمستخدمين دمج هذه الارتباطات في أي نظام إدارة تعلم (LMS) أو تجربة ويب وفقا لشروط استخدام واجهة برمجة تطبيقات Microsoft.
س: هل تظل البيانات التي تم إرجاعها من واجهة برمجة تطبيقات كتالوج Learn ثابتة أو تتغير؟
تتغير البيانات كلما تمت إضافة محتوى جديد أو تعديله أو حذفه، والذي يكون عادة على أساس يومي.
استجابة واجهة البرمجة API
س: هل يمكنني الحصول على جميع البيانات في وقت واحد؟
نعم. استخدم نقطة النهاية الأساسية، learn.microsoft.com/api/catalog للحصول على الاستجابة الكاملة. راجع مقالة مرجع مطور واجهة برمجة تطبيقات كتالوج Learn للحصول على مزيد من معلومات طلب واجهة برمجة التطبيقات.
س: هل يمكنني تصفية الاستجابة مسبقا؟
نعم. راجع عوامل تصفية الاستعلام المتوفرة في مقالة مرجع مطور واجهة برمجة تطبيقات كتالوج Learn.
س: هل واجهة المستخدم فريدة لكل كائن محتوى؟
نعم. يرمز UID إلى "المعرف الفريد" وهو فريد لكل كائن محتوى. إذا تغير UID، حتى إذا بقي العنوان أو بيانات التعريف الأخرى كما هي، يعتبر المحتوى كائنا جديدا.
س: لماذا توجد علامات HTML في ملخص الوحدة التدريبية؟
نحاول عادةً الحفاظ على تنسيق الملخص بسيطًا قدر الإمكان، لكن في بعض الأحيان نحتاج إلى إبراز نص معين أو ربطه.
س: لماذا لا توجد ارتباطات للوحدات الفردية؟
لا تتم كتابة الوحدات كمحتوى مستقل. الغرض منها أن يتم أخذها بترتيب محدد للوحدة النمطية. لهذا السبب، نقوم بتضمين الارتباط إلى صفحة تفاصيل الوحدة التدريبية والوحدة الأولى حتى يمكن للمستخدمين البدء من هناك ومتابعة المحتوى.
س: كيف يمكنني معرفة المحتوى الجديد؟
تخبرك قيمة last_modified بآخر تعديل للسجل.
س: هل تم تمكين تسجيل الدخول الأحادي (SSO) لارتباطات المحتوى؟
ليس في الوقت الحالي. نهدف إلى تمكين تسجيل الدخول الأحادي في المستقبل.
المحتوى
س: هل المعرف الفريد (UID) فريد بالنسبة للمحتوى؟
نعم. يرمز UID إلى "المعرف الفريد" وهو فريد لكل كائن محتوى. إذا تغير UID، حتى إذا بقي العنوان أو بيانات التعريف الأخرى كما هي، يعتبر المحتوى كائنا جديدا.
س: هل جميع الوحدات التدريبية جزء من مسار تعلم؟
لا. جميع الوحدات النمطية قادرة على الوقوف بمفردها، بمعنى أنها تعلم سيناريو أو مفهوما من طرف إلى طرف داخلها ولا تتطلب أخذ وحدات المتطلبات الأساسية. بالنسبة للبعض، هذا هو الأمر وهو ليس جزءا من مسار التعلم. بالنسبة للآخرين، يتم تجميعها معا في مسار تعلم واحد أو أكثر يأخذ المستخدم من خلال بناء مفاهيم أكثر تقدما. لا يجب أن تكون الوحدة النمطية جزءا من مسار التعلم، أو يمكن أن تكون جزءا من واحد أو أكثر.
س: كيف أعمل معرفة متى تمت إضافة المحتوى أو تحديثه أو حذفه؟
عند إضافة كائنات محتوى جديدة، تظهر ككائن جديد (تم تعريفه بواسطة UID) في الاستجابة. عند تعديل المحتوى، يمكنك معرفة ذلك استنادا إلى قيمته last_modified. عند حذف المحتوى، تتم إزالة كائن المحتوى من الاستجابة. على الرغم من وجود تأخير طفيف في بعض الأحيان في تحديث المحتوى في استجابة واجهة برمجة التطبيقات، عندما يتبع المستخدم عنوان URL للمحتوى، فإنهم يرون دائما أحدث المعلومات. عند حذف المحتوى، سيعاد توجيه عنوان URL القديم إلى المحتوى أو التجربة الجديدة، أو إلى الخيار الأفضل التالي.
وتجدر الإشارة إلى أنه يتم تحديث المحتوى طوال الوقت. ننشر التحديثات المتوفرة مرتين في اليوم. قد تكون إما ثانوية، مثل تغييرات النص الثانوية، أو رئيسية، مثل المراجعات الرئيسية أو الإضافات أو عمليات الحذف. بشكل عام، تتم إدارة محفظة المحتوى كمشروع ضخم ومحكم للغاية مفتوح المصدر مع الآلاف من المساهمين، وعلى هذا النحو، تحدث التغييرات في كل وقت. إذا كنت تستخدم واجهة برمجة تطبيقات كتالوج Learn في نظام الإنتاج الخاص بك، يجب أن تكون على دراية بذلك وأن يكون نظامك قادرا على التعامل معها.
س: تابعت رابطا مرجعيا للمحتوى، ولكنه يظهر لي الآن جزءا مختلفا عن المحتوى الذي توقعته. لماذا؟
نحن نسعى جاهدين لضمان عدم وصول أي شخص إلى طريق مسدود (404) مع روابط لموقعنا. عند تعديل المحتوى أو استبداله، نقوم بتنفيذ إعادة توجيه للارتباط القديم الذي سينقلك تلقائيا إلى المحتوى الجديد. في حالة إهمال المحتوى وعدم استبداله لأسباب مختلفة، سنقوم بإعادة التوجيه إلى المحتوى التالي الأنسب، والذي قد يكون نطاقا معدلا قليلا، أو إلى صفحة مقصودة، وما إلى ذلك.
س: كيف أعمل الوصول إلى كتالوجات نماذج الوثائق والفيديو والرمز؟
لا توجد طريقة برمجية في الوقت الحالي للوصول إلى هذه الكتالوجات. نهدف إلى تمكين الوصول البرمجي إلى هذه الكتالوجات في المستقبل.
الترجمة
س: ما هي اللغات المتوفرة في Microsoft Learn؟
هناك أكثر من 65 لغة متوفرة في Microsoft Learn. يمكنك رؤية قائمة كاملة هنا عبر تذييل الموقع (حدد اللغة التي تعرضها لمشاهدة القائمة الكاملة).
س: هل المحتوى متوفر بلغات أخرى؟
وهذا مشروط. نهدف إلى إتاحة المحتوى بجميع اللغات التي تتوفر بها المنتجات التي يتم تدريسها في المحتوى. عندما يزور المتعلمون موقع Microsoft Learn في الإعدادات المحلية المحددة، إذا لم يكن المحتوى متوفرا في تلك الإعدادات المحلية، يرى المستخدم الرأس والتذييل في الإعدادات المحلية المطلوبة، ويعود المحتوى الأساسي افتراضيا إلى اللغة الإنجليزية حتى يتوفر إصدار مترجم.
س: هل يختلف المحتوى لعنصر محتوى معين، استنادا إلى اللغة التي تعرضه بها؟
هذا الأمر ممكن. عند نشر التحديثات على المحتوى الإنجليزي، تعمل مسارات الترجمة لدينا على تحديث الإصدارات المترجمة في أقرب وقت ممكن - عادة في غضون أيام قليلة من التغيير الأصلي.
أخرى
س: هل هناك أي واجهة برمجة تطبيقات أو وظيفة لإعداد التقارير للحصول على بيانات مثل طرق العرض والنقرات والإكمال؟
ليس لدينا واجهة برمجة تطبيقات لإعداد التقارير في الوقت الحالي. لدينا وظيفة إعداد التقارير التنظيمية التي تسمح للمؤسسات بالإبلاغ عن اكتمال المستخدمين.
الخطوات التالية
يمكنك معرفة المزيد حول واجهة برمجة تطبيقات كتالوج Learn من خلال زيارة الارتباطات التالية: