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

تقدّم هذه الصفحة نظرة عامة موجزة على التفاعلات الرئيسية بين تطبيق الويب الإضافي وواجهة برمجة تطبيقات إضافات 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" لتحديد أحدث نسخة لدى الإضافة وانسخ الإعدادات منها لإنشاء نموذج مطابق جديد للمرفق على جانب الإضافة. ثم، اعرض واجهة المستخدم المناسبة للمرفقات.