المقارنة بين إضافات Classroom وأدوات LTI

إمكانية التشغيل التفاعلي لأدوات التعلّم (LTI) هي إطار عمل مفتوح لإنشاء عمليات دمج تابعة لجهات خارجية في أنظمة إدارة التعلّم. على الرغم من أنّ إضافات Classroom وأدوات LTI توفّر رحلات مستخدمين مشابهة، إلا أنّ إطارَي العمل غير متوافقَين بشكل مباشر. يقارن هذا الدليل بين نوعَي الدمج ويسلّط الضوء على الاختلافات الرئيسية بينهما. وتقدّم أيضًا اقتراحات حول طرق تحقيق تجارب مستخدم مماثلة عند تكييف أداة LTI للعمل كإضافة في Classroom.

التفاعلات بين المنصة والأدوات

يكمن الاختلاف الرئيسي بين أدوات LTI وإضافات Classroom في طريقة تبادل المعلومات. تستخدم أدوات LTI عادةً بروتوكول HTTP POST لنقل الحِملات إلى منصة LTI، بينما تنشئ إضافات Classroom الموارد وتسترجعها باستخدام Google Classroom REST API.

يلخّص الجدول التالي كيفية تحقيق سلوكيات أدوات LTI الرئيسية باستخدام Google Classroom.

الميزة	LTI	Classroom
إنشاء مهام	خدمات المهام والدرجات	إنشاء الموردَين CourseWork وAddOnAttachment
نشر الدرجات	خدمات المهام والدرجات	إرسال الواجبات باستخدام الإصدار CourseWork وAddOnAttachment
إطلاق المسارات	الربط بصفحة معيّنة	تحديد معرّفات الموارد المنتظمة (URI) في موارد AddOnAttachment
قراءة قوائم الدورات التدريبية	خدمات توفير الأسماء والأدوار	استرداد الملفات الشخصية Student وTeacher في دورة تدريبية

تكييف أداة LTI لتصبح إضافة Classroom

تتضمّن العديد من تفاعلات LTI عناصر مشابهة في إطار عمل إضافات Classroom. تتناول الأقسام التالية بعض المفاهيم الأساسية والإجراءات المقترَحة.

إعداد تطبيقك

تتطلّب جميع التفاعلات الآلية مع Google Classroom مشروعًا على Google Cloud. ستضبط إعدادات بطاقة بيانات تطبيقك في مشروع على السحابة الإلكترونية نفسه، والذي يحدّد طريقة ظهور الإضافة في Classroom للمستخدمين النهائيين. ستقدّم الرموز وتضبط اسم التطبيق ووصفه، كما ستضبط أذونات نطاق OAuth التي يتطلّبها منتجك.

في كثير من الأحيان، يكون تثبيت تطبيق الإضافة من بطاقة بيانات المتجر هو خطوة الإعداد الوحيدة التي يجب أن ينفّذها المستخدمون النهائيون. وهذا يشبه تفعيل أداة LTI ونشرها. لن يحتاج المستخدمون النهائيون إلى إكمال أي إجراءات تسجيل أو إدارة أي تفاصيل إعداد، ولكن قد يحتاج المشرف إلى السماح بالتطبيق في Marketplace وضبط أذونات الوصول إلى البيانات التابعة لجهات خارجية.

اقتراح: اتّبِع دليلنا حول إنشاء مشروع على Google Cloud وإعداده لاستخدام إضافة Classroom. الأهم من ذلك، حدِّد عنوان URL لتشغيل الإضافة باعتباره معرّف الموارد المنتظم (URI) الخاص باستكشاف المرفقات في حزمة تطوير البرامج (SDK) في "سوق Google Workspace". يمكن أن يكون عنوان URL هذا هو نفسه مسار تشغيل أداة LTI الحالية طالما أنّه يوجّه المستخدم إلى مسار المصادقة المناسب.

مسار المصادقة

يستخدم LTI تدفقًا من خطوتين يتم فيه تبادل رمز JWT موقَّع بين تطبيق العميل وخادم المصادقة. لا يحتاج المستخدمون إلى منح إذن وصول إلى بياناتهم لأي أداة، لأنّ الموافقة تكون ضمنية عندما يضبط المشرف الأداة.

في المقابل، فإنّ مسار OAuth في Google هو مسار ثلاثي الأطراف، يشمل المستخدم النهائي وتطبيق العميل الخارجي وخادم المصادقة. يتلقّى العميل رموزًا مميّزة بموافقة المستخدم الصريحة التي تمنح إذن الوصول إلى موارد Google Classroom الخاصة بالمستخدم.

يمكن لتطبيق إضافة تحقيق سلوك مشابه لرمز JWT الموقّع ذي الخطوتين باستخدام حسابات الخدمة. وهي حسابات تابعة لتطبيق بدلاً من مستخدم فردي، ويمكنها اتّخاذ إجراءات بدون موافقة المستخدم. يتطلّب استخدام حسابات الخدمة أن يضبط المشرف الإعدادات ويديرها. ننصح بشدة بعدم استخدام حسابات الخدمة التي لديها تفويض على مستوى النطاق، لأنّها قد تكون عرضة لإساءة الاستخدام. يمكنك الاطّلاع على دليلنا حول التفويض على مستوى النطاق باستخدام عمليات الدمج في Google Classroom للحصول على مزيد من التفاصيل.

اقتراح: عندما يتلقّى عنوان URL مرتبط بأداتك أو إضافتك طلبًا واردًا، افحص الطلب للتأكّد من توفّر مَعلمات طلب البحث الخاصة بإضافة Classroom. إذا كان ذلك متاحًا، استخدِم حزمة تطوير البرامج (SDK) الخاصة بخدمة "هوية Google" للحصول على بيانات اعتماد الوصول الخاصة بالمستخدم. خزِّن بيانات الاعتماد في جلسة المستخدم واستخدِمها لتقديم طلبات لاحقة إلى Classroom API. إذا لم تكن معلَمات طلب البحث متوفّرة، استخدِم طلبات HTTP للتفاعل مع نقاط نهاية LTI في المنصة.

إنشاء محتوى إضافي في Google Classroom

تتيح إضافات Classroom نوعًا واحدًا من المحتوى، وهو روابط عناوين URL إلى صفحات مستضافة خارجيًا. تتضمّن موارد AddOnAttachment هذه الروابط، التي تحدّد مسارات الويب التي يتم فتحها عندما يتفاعل المستخدم مع الإضافة. يتم فتح كل عنوان URL في سيناريوهات محدّدة، يمكنك الاطّلاع على أدلة إطارات iframe للحصول على التفاصيل الكاملة. تتشابه عناوين URL هذه مع روابط موارد LTI.

لا تتوافق إضافات Classroom مع أنواع المحتوى الأخرى، مثل الملفات أو الصور أو أجزاء HTML.

الاقتراح: عندما يختار المستخدم محتوًى في منتجك، احصل على بيانات اعتماد OAuth الخاصة به وأرسِل طلب AddOnAttachments.create. يجب أن يتضمّن الطلب عنصر AddOnAttachment يحتوي على عناوين URL لعرض الطالب وعرض المعلّم وعرض التقييم (اختياري). يُرجى العِلم أنّ هناك نقاط نهاية منفصلة لواجهة برمجة التطبيقات لإنشاء مرفقات في الإشعارات أو المهام أو المواد الدراسية. يمكن أن تتضمّن المرفقات التي تم إنشاؤها في المهام عرض التقييم فقط، لأنّ هذا هو النوع الوحيد من عناصر ساحة مشاركات Classroom الذي يقبل عملًا أرسله الطالب.

مقارنة ميزات الإطار

مواضع الدمج

تنشئ إضافات Classroom مرفقات في الإشعارات والواجبات الدراسية ومواد الدورة التدريبية. هذه هي العناصر التي تظهر في علامة التبويب "ساحة المشاركة" ضمن واجهة مستخدم Classroom.

يبدأ المعلّمون رحلة إنشاء مرفق الإضافة من خلال اختيار إضافة في أداة اختيار ضمن مسار إنشاء المهمة. راجِع أدلة إطارات iframe للحصول على مناقشة تفصيلية حول كل طريقة عرض تُقدَّم للمستخدمين.

بدلاً من ذلك، يمكن للمطوّرين إنشاء مهام آليًا باستخدام مرفقات الإضافات. يمكنك الاطّلاع على دليلنا حول إنشاء مرفقات خارج Google Classroom للحصول على التفاصيل.

معلومات سياق الإطلاق

يُلحق تطبيق Classroom عدة مَعلمات طلب بحث بكل عنوان URL عند فتح مسار إضافة. وتتضمّن هذه السمة دائمًا نوع عنصر البث ومعرّفات الدورة التدريبية وعنصر البث. قد تتوفّر معلومات أخرى حسب طريقة عرض الإطار iframe، مثل معرّفات المرفقات أو عمليات الإرسال، أو رمز مميّز للسماح بإنشاء المرفقات، أو عنوان URL للترقية من رابط إلى مرفق إضافة.

لا يمرّر Classroom أي معلومات عن المستخدم أو المؤسسة تلقائيًا. يمكنك الحصول على معلومات عن المستخدم من مرجع UserProfile في Classroom API، بما في ذلك معرّف المستخدم. إذا كان المستخدم مشرف نطاق، يمكنك الحصول على معلومات حول المؤسسة من خلال SDK لمشرف Workspace.

المصادقة والتفويض

يجب أن تستخدم إضافات Classroom ميزة تسجيل الدخول باستخدام حساب Google لمصادقة المستخدم. بعد تسجيل الدخول، يمنح المستخدمون تطبيقك الإذن من خلال نطاقات OAuth 2.0. يمكن لتطبيقك استخدام أي مجموعة من نطاقات OAuth المتاحة.

اكتشاف التطبيقات وإعدادها

يمكن للمستخدمين العثور على إضافات Classroom و "تثبيتها" من خلال Google Workspace Marketplace. يتيح التثبيت بنقرة واحدة لأي معلّم استخدام تطبيق إضافة. يمكن للمشرف بشكل اختياري تثبيت تطبيق الإضافة لجميع المعلّمين في وحدة تنظيمية أو نطاق. يمكن لجميع الطلاب في الدورة التدريبية الوصول إلى المرفقات التي تم إنشاؤها باستخدام التطبيق. ولا يحتاج المستخدمون النهائيون إلى إدارة الرموز المميزة أو المفاتيح أو المعرّفات الخاصة بكل إضافة من إضافات Classroom.

تجربة المستخدم ومسار المنتج

في كثير من الحالات، يكون مسار المنتج الحالي لأداة LTI مناسبًا تمامًا كإضافة في Classroom. على غرار أداة LTI، تتيح لك إضافة Classroom بشكل أساسي إنشاء روابط وإدارتها للوصول إلى المحتوى الخاص بك على منصتنا. تتشابه مرفقات إضافات Classroom مع روابط الربط بصفحة معيّنة في LTI. إذا كانت أداة LTI تنشئ عناوين URL تشير إلى المحتوى المستضاف، من المفترض أن تعمل بشكل جيد كإضافة في Classroom.

وضع درجات لأعمال الطلاب

يمكن عرض مرفقات إضافات Classroom وتقييمها في طريقة عرض التقييم في Classroom. عند إرفاق محتوى يتطلّب أن يرسل الطالب واجبًا، عليك توفير student_work_review_uri حيث يمكن للمدرّب الاطّلاع على عمل طالب معيّن ووضع درجة له. يختلف ذلك عن LTI، حيث تحدّد الأداة target_link_uri مشتركة بين المعلّمين والطلاب فقط. إنّ طريقة تنفيذ إضافات Classroom هي الأكثر تشابهًا مع خدمة مراجعة المهام الدراسية المتوافقة مع معيار LTI القادمة.