تناقش هذه الصفحة تفاصيل التنفيذ لإنشاء مرفق العمل على تسليمات الطلاب. لاحظ أنك قد تحتاج إلى تقديم المَعلمات ذات الصلة بالمرفقات عند إجراء هذه الطلبات.
إنشاء مرفق
أنشئ مرفقًا من خلال إصدار طلب CREATE إلى الملف
نقطة نهاية courses.*.addOnAttachments.create. يجب أن يتضمن طلبك
مثيل لـ AddOnAttachment في نص الطلب.
يجب إدراج الحقول التالية عند إنشاء مرفق:
title: اسم السلسلة للمرفق.teacherViewUri: معرّف الموارد المنتظم (URI) الخاص بـ "عرض المعلّمين" الخاص بالمرفق.studentViewUri: معرّف الموارد المنتظم (URI) الخاص بطريقة عرض الطالب للمرفق.studentWorkReviewUri: معرّف الموارد المنتظم (URI) الخاص بالمعلّم لمشاهدة عمل الطالب المرفق. هذا الحقل مطلوب فقط للمرفقات من نوع النشاط.
يمكنك تضمين بعض الحقول الاختيارية التالية:
dueDateوdueTimeفي حال تحديد تاريخ استحقاق المرفق.maxPoints: الحد الأقصى للدرجة للمرفق. يجب إدخال قيمة غير صفرية. إذا كنت ترغب في دعم تراجع الدرجات. ينطبق على المرفقات من نوع النشاط فقط.
اطّلِع على مرجع موارد "AddOnAttachment" للحصول على مزيد من التفاصيل حول هذه الحقول.
تفاصيل عمليات الإرسال التي أجراها الطالب
يتّبع سير عمل الإرسال النموذجي الخطوات التالية:
- يشغِّل الطالب
studentViewUriلإكمال نشاط. - تسترد الإضافة
submissionIdمن الطريقةgetAddOnContextباستخدام بيانات اعتماد الطالب. - يتم تخزين
submissionIdوattachmentIdمن خلال الإضافة. المطور باعتباره المعرف الفريد لعمل الطالب. في حال أن ينسخ معلّم مهمة دراسية في Classroom، فيمكنك استخدام مفتاح مركب لهاتين المعلمتين لعرض مرفق جديد في المهمة المنسوخة. لمزيد من التفاصيل، يمكنك الاطّلاع على صفحة المحتوى المنسوخ. - يطلق معلم مهتم بمراجعة عمل الطالب
studentWorkReviewUriيتضمّن الطلب مَعلمات طلب البحث التالية: "courseId" و"itemId" و"itemType" و"attachmentId" و"submissionId" - يستخدم مطوّر الإضافة هذه المعرّفات الأربعة لاسترداد عمل الطالب. استخدام
نقطة نهاية
courses.courseWork.addOnAttachments.studentSubmissionsاسترداد أو تعديل المعلومات المتعلقة بإرسال الطالب.
اكتشاف حالة الإرسال
إصدار طلب للحصول على رصيد بقيمة GET
نقطة نهاية courses.courseWork.addOnAttachments.studentSubmissions للحصول على
تحتوي على تفاصيل حول submissionId محدد. تتلقى
عنصر واحد (AddOnAttachmentStudentSubmission) يحتوي على درجة الإرسال
(pointsEarned) والحالة الحالية (postSubmissionState). حالة الإرسال
يمكن أن تكون القيمة واحدة من القيم التالية:
NEW، إذا لم يسبق للطالب الوصول إلى المهمة الدراسيةCREATED، إذا أنشأ الطالب مهمة ولكن لم يرسلها بعد.TURNED_IN، إذا كان الطالب قد أرسل عمله إلى المعلّمRETURNED، إذا أرجع المعلّم المهمة إلى الطالب.RECLAIMED_BY_STUDENT، إذا كان الطالب "لم يتم إرساله" عملهم.
استخدِم نقطة النهاية هذه لرصد حالة عمل الطالب في الإضافة. إِنْتَ ثم تعديل طرق العرض أو الخيارات المقدمة للطالب اعتمادًا على التي تم إرجاعها. وقد يشمل ذلك الميزات التالية:
- عرض حالة تسليم المهام ضمن الإضافة هذا قد مساعدة الطلاب في تجنب الالتباس المحتمل وضمان عدم حدوث عدم تسليم مهمة دراسية.
- فرض قيود على امتيازات تعديل عمليات الإرسال إذا كانت حالة المهمة
CREATEDأوRECLAIMED_BY_STUDENT، قد يُسمح للطالب بتعديل المشروع. إذا كانت حالة التعيين هيTURNED_INأوRETURNED، قد لا يتم السماح للطالب بتعديل محتواه.
الدرجات والمرفقات المتعددة
يمكن استخدام مرفق إضافة واحد فقط لضبط الدرجة لأغنية منفردة.
المهمة. إذا أنشأ المعلم أكثر من مرفق من نوع النشاط
على القيمة maxPoints، فيمكن فقط للمرفق الأول تحديد
درجة المهمة. يمكنك ترك قيمة maxPoints بدون ضبط أو ضبطها على صفر.
إيقاف التراجع عن الظهور في الدرجة لمرفق.
تحديد درجة المحتوى الذي أرسلته
يمكنك تعديل طلب الطالب الذي أرسلته من خلال إرسال طلب PATCH إلى
نقطة نهاية courses.courseWork.addOnAttachments.studentSubmissions. الطلب
يجب أن يشتمل النص الأساسي على مثيل لـ AddOnAttachmentStudentSubmission مع
القيم المعدّلة. يمكنك ضبط الحقل pointsEarned لتعديل درجة الإرسال.
تصبح القيمة التي تم تمريرها في pointsEarned درجة مسودة مرئية
المعلّم في واجهة مستخدم Classroom. يمكن للمعلّمين تعديل الدرجة الأولية.
قبل إرجاع المهمة إلى الطلاب. يمكنك الاطّلاع على مقالة نظرة عامة على وضع الدرجات في
واجهة مستخدم Classroom للاطّلاع على تفاصيل حول طريقة وضع الدرجات
وتقديمها للمعلمين.
يُرجى العلم أنّه لا يمكنك ضبط الدرجة باستخدام "pointsEarned" إلا في الحالات التالية:
صواب:
- يجب أن يحتوي المرفق على قيمة
maxPointsموجبة. - يجب أن تكون الإضافة هي المنشئ الأصلي للمرفق.
لاحظ أيضًا أنه يمكنك تعديل maxPoints لـ AddOnAttachment تم إنشاؤه مسبقًا.
من خلال إصدار طلب PATCH إلى نقطة النهاية addOnAttachments.
متى يجب وضع درجة
سيكون لديك بعض الخيارات عند إعادة الدرجة إلى Google Classroom. تشير رسالة الأشكال البيانية هو ما إذا كنت تريد تخزين بيانات اعتماد المعلم، يمكن للمعلم فقط تعديل الدرجة.
هناك لحظتان إضافيتان يمكنك فيهما اجتياز درجة Google Classroom: عندما يكمل الطالب عمله أو عندما يكمل المعلّم عمله. يفتح عمل الطالب في إطار iframe لمراجعة عمل الطالب.
إذا كنت تريد وضع الدرجات عند إكمال الطالب للعمل، يجب تخزين بيانات اعتماد المعلم بلا اتصال بالإنترنت، ثم استردادها واستخدامها لتعديل الدرجة عندما يكمل الطالب العمل. توفر هذه الطريقة بعض الإمكانات الفوائد:
- تقديم تحديثات سلسة بشأن الدرجات. لا يحتاج المعلمون إلى اتخاذ أي إجراءات التسبب في تعبئة الدرجات في واجهة مستخدم Classroom.
- هي فئة تطبيقات توفّر إحصاءات في الوقت الفعلي حول مستوى تقدُّم الطلاب في إحدى المهام الدراسية. يمكن للمعلّمين الحصول على فكرة من خلال ضبط الدرجات أثناء إكمال الطلاب للمرفقات. من تقارير الطلاب الفهم دون فتح كل عملية إرسال.
تجدر الإشارة إلى أن هذا المنهج يتيح أيضًا منهجًا غير متزامن لتصنيف
المزامنة. يمكنك استطلاع AddOnAttachmentStudentSubmission بشكل دوري.
نقطة نهاية للكشف عند تسليم الطالب لعمله. عندما كان
تم إرساله، قم بتعيين درجة الإرسال باستخدام بيانات الاعتماد المحفوظة.
إذا كنت لا تريد تحميل بيانات اعتماد المعلّم أثناء جلسة الطالب، يمكنك استخدام بيانات اعتماد المدرس النشط عند تحميل بيانات اعتماد المشروع في إطار iframe لمراجعة عمل الطالب. ومع ذلك، قد لا يوفر ذلك تجربة المستخدم سلسة للغاية كدرجات في واجهة مستخدم Classroom في الوقت الفعلي وسيُطلب من المعلمين فتح إطار iframe لمراجعة عمل الطالب للإرسال.
رصد التغييرات في درجات المهام الدراسية
يمكن للمعلّمين تعديل إعدادات الدرجات في Classroom بعد إنشاء مهمة دراسية. قد تؤدي هذه التعديلات تشمل:
- تغيير قيمة النقاط المعينة.
- تغيير قيمة
maxPointsللمهمة - تغيير ما إذا كان يجب وضع درجات للمهمة أم لا.
للاطّلاع على الإعدادات الحالية لوضع الدرجات لمهمة، ننصحك بإرسال
طلب GET إلى نقطة نهاية courses.courseWork. يتضمن الرد
قيمة maxPoints الحالية. لا تحتوي المهمة التي لم يتم تقييمها على درجات على قيمة أي شيء أو صفر
قيمة maxPoints.
إذا كنت قد اجتزت الدرجة مرة أخرى إلى Classroom، استخدم
نقطة نهاية courses.courseWork.addOnAttachments.studentSubmissions التي تريد استرجاعها
تغيير الدرجة لمرفق إضافة. يتم تعيين قيمة الدرجة باستخدام
الحقل "pointsEarned". ننصحك بالتحقّق من هذه القيمة وتعديلها إذا لزم الأمر.
إذا كان منتجك يسمح للمعلّمين بتعديل درجة الطالب لمستوى معيّن
الأخرى.