دمج CourseWork

يمكن للمطوّرين استخدام Google Classroom API للتفاعل مع الدورات الدراسية في Google Classroom. ويُشار إلى التطبيق الذي يستخدم واجهة برمجة التطبيقات بهذه الطريقة باسم دمج CourseWork.

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

آلية العمل

تتمثل الميزة الأساسية لدمج CourseWork في إنشاء assignments (المهام الدراسية) وannouncements (الإشعارات) وcourse materials (مواد الدورة التدريبية) وإدارتها باستخدام Classroom API.

من الأمثلة على تجارب المستخدمين الشائعة التي تتيحها عملية دمج CourseWork هو السماح للمعلّمين باكتشاف المحتوى وتوزيعه وتقييمه من داخل موقعك الإلكتروني أو تطبيقك:

  1. سجّل مستخدم معلّم الدخول إلى موقعك الإلكتروني.
  2. يعثر المعلّم على محتوى يريد مشاركته مع صفّه أو ينشئه. ينقر المعلّم على زر على موقعك الإلكتروني لإرسال هذا المحتوى إلى Google Classroom.
  3. يُرسِل تطبيقك طلبًا إلى courses.courseWork.create. يحتوي الطلب على عنصر CourseWork في نصه يحتوي على ما يلي:
    • رقم تعريف الدورة التدريبية المقصودة.
    • عنوان المهمة
    • الوصف النصي للمهمة
    • link Material يتضمّن عنوان URL للمحتوى الذي اختاره المعلّم
    • اختياريًا، الحد الأقصى للنتيجة التي يمكن تحقيقها للمحتوى المحدّد
  4. تظهر مهمة جديدة في Classroom مع إرفاق رابط. يشير الرابط إلى عنوان URL المحدّد في طلب create. راجِع الشكل 1 للاطّلاع على مثال.
  5. يظهر أيضًا عمود جديد للمهمة الدراسية في ملف علامات Classroom، بما في ذلك الحد الأقصى للنتيجة في حال توفّرها.
  6. يتلقّى الطلاب المهمة الدراسية وينقرون على link Material لفتح عنوان URL الذي تم تقديمه في علامة تبويب جديدة والاطّلاع على المحتوى على موقعك الإلكتروني أو إكماله. يمكنك اختياريًا توفير عناصر تحكّم للطالب لتسليم المهمة.
  7. يمكنك اختياريًا إرسال طلب إلى courses.courseWork.studentSubmissions.modifyAttachments لإضافة مرفقات إلى عمل الطالب الذي أرسله، مثل ملف على Google Drive أو link Material يشير إلى عمل الطالب على موقعك الإلكتروني.
  8. يمكنك اختياريًا إرسال طلب إلى courses.courseWork.studentSubmissions.patch لضبط درجة الطالب للمَهمّة.

تعديل مهمة CourseWork مع إرفاق مادة الرابط

الشكل 1: عرض المعلّم عند تعديل مهمة باستخدام link Material تم إنشاؤها من خلال عملية دمج CourseWork

بدلاً من ذلك، يمكنك الاتصال بـ courses.announcements.create أو courses.courseWorkMaterials.create لإنشاء إشعار أو مادة مهمة في الدورة بدلاً من مهمة. اطّلِع على صفحتَي إنشاء الدورات الدراسية وإدارتها وضبط الدرجات وتعديلها للحصول على أوصاف تفصيلية لإجراءات Classroom API ذات الصلة.

الاعتبارات

يُرجى مراعاة ما يلي قبل تحديد ما إذا كان دمج CourseWork هو الخيار المناسب لاحتياجات منتجك.

  • يجب تفويض المستخدم وطلب موافقته. يتم إرسال طلبات واجهة برمجة التطبيقات نيابةً عن المستخدم. ويعني ذلك، على سبيل المثال، أنّه لا يمكنك إنشاء مواد دراسية في أي دورة تدريبية على Google Classroom، بل يمكنك فقط إنشاء مواد دراسية في الدورات التدريبية التي يدرّسها المستخدم المفوَّض.
  • يجب أن تتوفّر للمستخدم طريقة لاختيار دورة تدريبية لتلقّي المحتوى. ننصحك باستخدام courses.list للحصول على قائمة بالدورات التدريبية التي يدرّسها المستخدم، ثم السماح للمستخدم باختيار دورة تدريبية واحدة أو أكثر من القائمة.
  • عندما ينقر أحد المستخدمين على link Material في Classroom، يتم فتح الرابط في علامة تبويب جديدة. لن يتلقّى خادمك أي معلومات من Classroom عند فتح عنوان URL.
  • يمكن للمعلّم تعديل المقرر الدراسي أو حذفه بغض النظر عن المطوّر. وهذا يعني أنّ معرفة المطوّر بالمواد الدراسية قد تصبح قديمة. إذا كنت بحاجة إلى معرفة التغييرات في الدورات الدراسية، ننصحك بإعداد الإشعارات الفورية للاطّلاع على التغييرات في الدورات الدراسية.
  • يمكن للمعلّم إنشاء أعمال دراسية في واجهة مستخدم Classroom باستخدام روابط مصقّلة لعناوين URL على موقعك الإلكتروني. إنّ الأعمال الدراسية التي يتم إنشاؤها بهذه الطريقة تتعلّق بالمعلّم فقط، لذا لن تتمكّن من عرض علامات الإرسال أو تعديلها أو ضبطها باستخدام Classroom API.