دمج CourseWork

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

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

آلية العمل

الميزة الأساسية لعملية الدمج CourseWork هي إنشاء وإدارة الواجبات والإشعارات ومواد الدورات التدريبية باستخدام 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 MaterialCourseWork

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

الاعتبارات

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

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