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

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

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

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

• عند فتح إطار iframe لاستكشاف المرفقات، أنشئ courseWork.GetAddOnContextRequest أو courseWorkMaterials.GetAddOnContextRequest أو announcements.GetAddOnContextRequest استنادًا إلى itemType للتحقق من صحة دور المستخدم والحصول على القيمة supportsStudentWork.
• يمكنك عرض واجهة المستخدم الخاصة باكتشاف المحتوى أو إنشائه. يمكنك حذف مرفقات من نوع النشاط استنادًا إلى قيمة supportsStudentWork من استجابة التحقّق من صحة الإطلاق.
• بناءً على اختيارات المعلّم، يمكنك تقديم طلب إضافة واحدة أو أكثر من طلبات "create" لإضافة مرفقات إلى المهمة.

إطارات iframe أخرى

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

• عند فتح إطار iframe، عليك الحصول على موافقة OAuth الخاصة بالمستخدم ثم التحقّق من دوره ومعرّف المرفق.

  • إذا كان المستخدم الحالي طالبًا، اربط submissionId من الرد بعمل الطالب. هذا الإجراء مطلوب لتمرير الدرجات النهائية ولعرض عمل الطالب على المعلّمين في أداة وضع الدرجات، حيث تتم مطابقة submissionIds في جميع طرق العرض.
  • إذا كانت الإضافة معروفة "attachmentId"، اعرض واجهة المستخدم المناسبة للمرفق.
  • بخلاف ذلك، يجب أن يكون المنشور الرئيسي لهذا المرفق قد تم نسخه من منشور أو دورة تدريبية أخرى. يمكنك استخدام copyHistory لتحديد أحدث نسخة اطّلع عليها الإضافة ونسخ الإعدادات منها لإنشاء نموذج جديد مقابل للمرفق على جانب الإضافة. بعد ذلك، اعرض واجهة المستخدم المناسبة للمرفق.
  ملاحظة مهمة: قد تواجه حالةً قصوى هنا، إذ قد يكون أول مستخدم يصل إلى هذا المرفق طالبًا.