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

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