اعتبارات رئيسية

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

مفاهيم Google Classroom

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

الدورات التدريبية وأدوار المستخدمين

الدورة التدريبية هي الوحدة التنظيمية المركزية التي تربط بين المعلمين بالطلاب. الدورات التدريبية هي أعلى مستوى من التنظيم في Google Classroom API.

ويمكن إضافة مستخدمين فرديين إلى دورة تدريبية بصفتهم "معلِّمين" أو "طلاب". دور المستخدم في الدورة التدريبية غير مرتبط بدوره في مؤسسته. وهذا يعني أنّ الطالب في المدرسة يمكن أن يكون معلِّمًا في دورة تدريبية، كما يمكن أن يكون أعضاء المعلّمين طلابًا في الدورات التدريبية. في حين أن الحالة الأكثر شيوعًا هي أن تمثل الدورة التدريبية مادة أكاديمية مجدولة بانتظام، يتم أيضًا إنشاء الدورات التدريبية لتنظيم نوادي الطلاب أو إجراء التطوير المهني.

ينطبق ما يلي على جميع الدورات التدريبية في Google Classroom.

بالنسبة إلى معلّمي الدورات التدريبية:

  • قد يكون للدورة التدريبية أكثر من معلّم واحد.
  • ويمكن إضافة المعلّمين إلى دورة تدريبية في أي وقت.
  • قد تتم إزالة المعلّمين من دورة تدريبية في أي وقت.

مصدر البيانات

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

ينشئ المعلِّمون الإشعارات في أعلى صفحة "ساحة المشاركات" في واجهة مستخدم Classroom. ينشئ المعلمون المهام والمواد من خلال النقر على الزر إنشاء في علامة التبويب "الواجب الدراسي". يمكن للمطوّرين إنشاء هذه الرموز آليًا من خلال Classroom API

المهمة هي عنصر بث يمكنه قبول المهام الدراسية التي أرسلها الطالب. المهام الدراسية هي النوع الوحيد من عناصر ساحة المشاركات الذي يظهر في دفتر العلامات والذي يمكن أن يحتوي على مرفق إضافة.

بالنسبة إلى عناصر البث:

  • قد يتم تعيين مهمة أو مادة لمجموعة فرعية من الطلاب في الدورة.
  • قد يتم وضع درجة أو عدم وضع درجات لإحدى المهام الدراسية. يمكن للمعلمين تغيير حالة الدرجات لمهمة في أي وقت.
  • يمكن أن يكون للمهمة أكثر من مرفق واحد.
  • قد تشتمل المهمة على أنواع مختلفة من المرفقات. على سبيل المثال، قد تحتوي إحدى المهام على "مستندات Google" وفيديوهات YouTube ومرفقات الإضافات في آن واحد.
  • يمكن أن تتضمّن المهمة مرفقات إضافية من أكثر من مطوّر برامج واحد.
  • ويمكن لمطوّري البرامج الحصول على معلومات حول أي عنصر بث وتعديلها باستخدام أحد مرفقات الإضافات.
  • يمكن للمطوّرين تسليم المهام التي أرسلها الطالب أو استردادها أو إرجاعها في ما يتعلق بمهمة تتضمن إحدى مرفقات الإضافات.
  • لا يمكن لمطوّري البرامج ضبط الدرجات إلا لعمليات إرسال الطلاب الفردية في المهام التي ينشئونها.

تم نسخ عناصر البث

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

مؤسسة المستخدم

لا تعرض واجهة برمجة التطبيقات Google Classroom API معرّفات لمؤسسة المستخدم أو المبنى أو أي عضوية أخرى أعلى من مستوى الدورة التدريبية.