استراتيجية التنفيذ

تقدّم هذه الصفحة نظرة عامة مختصرة حول التفاعلات الرئيسية بين الإضافة على الويب التطبيق وواجهة برمجة تطبيقات إضافات Google Classroom.

إطار iframe لاكتشاف المرفقات

إن إطار iframe لاكتشاف المرفقات هو الصفحة المقصودة للمعلمين في الإضافية. ننصحك باتخاذ الإجراءات التالية بشأن هذا العرض:

• عرض واجهة مستخدم استكشاف المحتوى أو الإنشاء

  بشكل اختياري، حدد ما إذا كان عنصر ساحة المشاركات سيقبل ردود الطلاب أم لا، إذ قد ترغب في منع المعلّم من إضافة نوع النشاط المرفقات. تحقّق من قيمة معلَمة طلب البحث itemType التي كانت تم تمريره عند فتح الإضافة iframed. يقبل فقط النوع courseWork ردود الطلاب.

• استنادًا إلى اختيارات المعلّمين، يمكنك إرسال طلب إضافة واحدة أو أكثر من "create" إلى وإضافة مرفقات إلى المهمة.

إطارات iframe أخرى

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

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

ملاحظة مُهمّة: قد تظهر لك حالة هامشية هنا. المستخدم الأول للوصول إلى هذه المرفق يمكن أن يكون طالبًا.