تقدّم هذه الصفحة نظرة عامة موجزة على التفاعلات الرئيسية بين تطبيقات الويب المكوّنة من الإضافات وواجهة برمجة التطبيقات الخاصة بإضافات Google Classroom.
إطار iframe لميزة "اكتشاف المرفقات"
إطار iframe لميزة "استكشاف المرفقات" هو الصفحة المقصودة للمعلّمين في إضافة التدريس. ننصحك باتّخاذ الإجراءات التالية بشأن طريقة العرض هذه:
عرض واجهة المستخدم لاكتشاف المحتوى أو إنشائه
يمكنك اختياريًا تحديد ما إذا كان عنصر البث سيقبل ردود الطلاب، لأنّك قد تريد منع المعلّم من إضافة مرفقات من نوع النشاط. تحقّق من قيمة مَعلمة طلب البحث
itemTypeالتي تم إرسالها عند فتح إطار iframe للإضافة. لا يقبل سوى النوعcourseWorkإجابات الطلاب.استنادًا إلى اختيارات المعلّم، يمكنك تقديم طلب واحد أو أكثر من طلبات
createالإضافية لإضافة مرفقات إلى المهمة الدراسية.
إطارات iframe الأخرى
إنّ إطار iframe لعرض الطلاب وإطار iframe لمراجعة أعمال الطلاب وإطار iframe لعرض المعلّمين كلها مخصّصة لعرض المحتوى للمستخدم بدلاً من تعديل مهمة في Classroom. ننصحك باتّخاذ الإجراءات التالية بشأن هذه المشاهدات:
- عند فتح إطار iframe، احصل على موافقة المستخدم على OAuth، ثم تحقّق من دوره ورقم تعريف المرفق.
- عند فتح إطار iframe، أنشئ
courseWork.GetAddOnContextRequestأوcourseWorkMaterials.GetAddOnContextRequestأوannouncements.GetAddOnContextRequestاستنادًا إلىitemTypeللتحقّق من validity دور المستخدم. - إذا كان المستخدم الحالي طالبًا، اربط
submissionIdمن الاستجابة بعمل الطالب. هذا الإجراء مطلوب لإرسال الدرجات و لعرض أعمال الطلاب للمعلّمين في أداة وضع العلامات، ويجب أن يكونsubmissionIdsمطابقًا في جميع طرق العرض. - إذا كانت الإضافة تعرف
attachmentId، يجب عرض واجهة مستخدم مناسبة للمرفق. - بخلاف ذلك، يجب أن يكون قد تم
نسخ المشاركة الرئيسية لهذا المرفق من مشاركة أو دورة تدريبية أخرى. استخدِم
copyHistoryلتحديد أحدث نسخة تعرفها الإضافة ونسخ الإعدادات منها ل إنشاء نموذج جديد مطابق للمرفق من جانب الإضافة. بعد ذلك، أظهِر واجهة مستخدم المرفق المناسبة.