دمج CourseWork

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

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

يُستخدَم مسار الدمج هذا عادةً لإنشاء المهام الدراسية ووضع الدرجات عليها باستخدام روابط تؤدي إلى مراجع خارج 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 بدلاً من ذلك.

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

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