دمج 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 لضبط درجة الطالب للمَهمّة.

الشكل 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.