متطلبات الإضافات

الإصدار 1.0، 30 نيسان (أبريل) 2024.

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

يجب استخدام الكلمات الرئيسية "يجب" و"يجب ألا" و"مطلوب" و"SHALL" و"SHALL NOT" و"يجب" "SHOULD NOT" و"RECOMMENDED" و"MAY" و"OPTIONAL" في هذه الوثيقة كما هو موضح في RFC 2119.

المتطلبات

رقم التعريف النوع
1.0 ترخيص المستخدم النهائي (إن توفّر)
  1.1 يجب أن تظهر رسالة سهلة الاستخدام للمستخدم إذا لم يكن لديه ترخيص. يجب أن تذكر الرسالة بوضوح سبب تعذُّر استخدام الإضافة وتقترح إجراءً يمكن للمستخدم من خلاله معالجة هذا الموقف. مطلوب
  1.3 يجب أن تحدّد بيانات الإضافة على Google Workspace Marketplace تفاصيل حول متطلبات الترخيص التي قد تكون مطلوبة لاستخدام الإضافة. إذا كانت الإضافة تتضمن فئة مدفوعة، يجب أن توفّر بيانات السوق رابطًا إلى صفحة ويب تقدّم مزيدًا من المعلومات حول الأسعار أو كيفية التواصل مع مندوب مبيعات. مطلوب
2.0 تسجيل دخول المستخدم
  2.1 يجب أن يسجّل المستخدمون المعلِّمون الدخول إلى الإضافة باستخدام خدمة "الدخول المُوحَّد" من Google.
إذا طُلب من المستخدمين من الطلاب تسجيل الدخول إلى الإضافة، يجب عليهم تسجيل الدخول باستخدام خدمة "الدخول المُوحَّد" من Google.		 مطلوب
  2.2 يجب أن تستخدم الإضافة خدمة الدخول المُوحَّد (SSO) من Google لتسجيل دخول المستخدم تلقائيًا في الزيارات اللاحقة بدون عرض طلب بتسجيل الدخول.
عندما لا ينتج عن تلميح تسجيل الدخول تطابق مع المستخدم الذي سجّل الدخول حاليًا، يجب أن تطلب الإضافة من المستخدم باستخدام زر تسجيل الدخول وتمرير user_hint إلى مكتبة المصادقة لفلترة الحسابات غير الصالحة.		 مطلوب
  2.7 إذا لم يسبق لمستخدم Classroom تسجيل الدخول إلى الإضافة (كما هو محدد من خلال الاطّلاع على تلميح تسجيل الدخول)، يجب أن تعرض الإضافة ميزة "تسجيل الدخول باستخدام حساب Google". زرّ لإجراء المستخدِم الصريح لبدء عملية تسجيل الدخول.
ملاحظة: يُعدّ هذا الإجراء ضروريًا لاستيفاء إرشادات العلامة التجارية من Google ويساعد أيضًا في تجنُّب أدوات حظر النوافذ المنبثقة.		 مطلوب
  2.8 يجب أن تعرض الإضافة هوية المستخدم الذي سجّل الدخول حاليًا. موصى به
3.0 الإعدادات العامة
  3.1 يجب أن تلتزم الإضافة بإرشادات الموافقة العامة في Google Workspace Marketplace. مطلوب
  3.2 إذا تم إطلاق مهمة في علامة تبويب أو نافذة جديدة من أي من رحلات iframe، يجب أن يتم تقديم رسالة سهلة الاستخدام للرجوع إليها في Classroom. مطلوب
  3.3 على المستخدم إكمال رحلته باستخدام سير عمل إضافي فقط وعدم الانتقال إلى إجراءات سير عمل الدورة التدريبية أو استخدام زر المشاركة في Classroom. مطلوب
  3.4 خيار الترجمة: يجب أن يتم تحديد اللغة استنادًا إلى الإعدادات المفضّلة المحلية التي يضبطها المتصفّح عند توفّرها. موصى به
  3.5 إذا كانت الإضافة تحدّد maxPoints، يجب أيضًا ضبط pointsEarned عندما يُكمل الطالب عملية إرسال باستخدام بيانات اعتماد المعلّم المخزّنة (إجراء يُنصح به) أو عندما يفتح المعلّم عملية الإرسال في إطار iframe لمراجعة عمل الطلاب. مطلوب
  3.9 يجب أن تتوافق الإضافات مع إرشادات WCAG 2.1 مستوى AA بشأن إمكانية الوصول. سيبلغ مطوّرو الإضافات ذاتيًا عن استيفاء هذا الشرط عند إرسالها وأنّ الإضافة ستظل متوافقة مع التغييرات المستقبلية التي ستطرأ. موصى به
  3.10 يجب أن تكون أي أخطاء يواجهها المستخدم مقروءة. مطلوب
  3.11 إذا تم تشغيل studentViewUri أو teacherViewUri أو studentWorkViewUri من مهمة دراسية تم نسخها أو دورة تدريبية تم نسخها، يجب ألا تعرض الإضافة صفحة خطأ في إطار iframe. مطلوب
  3.12 إذا تم تشغيل studentViewUri أو teacherViewUri أو studentWorkViewUri من مهمة دراسية تم نسخها أو دورة تدريبية تم نسخها، يجب أن تعرض الإضافة مرفقًا جديدًا ليكمله الطالب، ويجب ألا تعرض ردود الطالب من المهام الدراسية أو الدورات التدريبية السابقة في إطار iframe. موصى به
4.0 اكتشاف المرفقات
  4.1 إذا كان المرفق يتطلب إرسال الطالب، يجب أن يشتمل المرفق على studentWorkReviewUri حتى يتم التعامل معه على أنّه نوع نشاط وليس نوع محتوى. مطلوب
  4.2 يجب أن يوفر إطار iframe لاكتشاف المرفقات واجهة مستخدم توفر واحدًا على الأقل مما يلي:
  • إنشاء محتوى جديد لإرفاقه
  • تصفُّح المحتوى واختياره وإرفاقه من مكتبة محتوى
  • تعليمات لإرفاق محتوى من موقعك الإلكتروني أو منتجات أخرى
 مطلوب
  4.3 يجب أن يتمكن المعلّم من العثور على جميع المحتوى/الأنشطة المتاحة للمعلّم والوصول إليها. موصى به
  4.4 يجب أن يتمكن المعلّم من معاينة المحتوى/النشاط قبل الالتزام بإرفاقه بالمهمة. مطلوب
  4.5 إذا كان العمل مطلوبًا من قبل المعلّم لإنشاء المحتوى/النشاط قبل إرفاقه، يجب إكمال هذا العمل في إطار iframe. موصى به
5.0 طريقة عرض الطلاب
  5.1 عند إطلاق "studentViewUri"، يجب ألا تخرج الإضافة المستخدم من إطار iframe لإكمال مهمة.
إذا كانت الإضافة تخرج المستخدم من إطار iframe، يجب أن تكون هناك رسالة أو مؤشر آخر توجّه الطلاب إلى استخدام Classroom.		 موصى به
  5.2 إذا انبثق نشاط إضافة من إطار iframe، يجب أن تكون هناك معاينة للمهمة في إطار iframe. مطلوب
  5.3 إذا تطلب أحد الأنشطة من أحد الطلاب اتخاذ إجراء لوضع علامة على العمل أنه انتهى، يجب ألا يكون الزر بعنوان "تسليم" لتجنُّب حدوث أي التباس مع زر التسليم في Classroom. مطلوب
6.0 طريقة عرض المعلّمين
  6.1 يجب أن يتمكن المعلّم من رؤية ما سيراه الطالب عند أداء المهمة. موصى به
7.0 مراجعة عمل الطالب
  7.1 إذا تم إطلاق studentWorkReviewUri، يجب أن تعرض الإضافة عمل الطالب لمراجعة المعلّم ضمن إطار iframe. قد يتم ربط المواد التكميلية خارج إطار iframe. مطلوب
  7.2 يجب ألا تتيح الإضافة التنقّل بين الطلاب في طريقة العرض "studentWorkReviewUri". يجب إجراء التنقّل بين الطلاب في واجهة مستخدم Classroom فقط. مطلوب
8.0 دعم Classroom للأجهزة الجوّالة
  8.1 عند إطلاق تطبيق Classroom المتوافق مع الأجهزة الجوّالة teacherViewUri أو studentViewUri أو studentWorkReviewUri، يجب أن يفتح عنوان URL التطبيق الأصلي للأجهزة الجوّالة للشريك أو تطبيق الويب للأجهزة الجوّالة الخاص بالشريك، وفي كلتا الحالتين رابطًا لموضع معيّن في طريقة العرض الصحيحة. إذا كان الجهاز غير متوافق، يجب عرض رسالة للمستخدم لإعلامه بأنه جهاز غير متوافق، ومن المفترض أن يتم عرض الأجهزة المتوافقة معه. مطلوب
  8.2 يجب توفير إمكانية إكمال عمل الطالب على الجهاز الجوّال. موصى به
9.0 ميزات إضافية
  9.1 إذا كان بإمكان المعلّمين لصق الروابط المؤدية إلى المحتوى كمرفقات الروابط، عليك ترقية الروابط إلى مرفقات الإضافات. موصى به
  9.2 في حال استخدام عملية دمج CourseWork لإنشاء مهام من خارج Classroom، عليك إنشاء مرفقات الإضافات تلقائيًا لجميع الروابط المتوافقة مع الإضافة. موصى به

سجلّ التغييرات

الإصدار 1.0 تاريخ التعديل: 30 أبريل 2024
1.1 بإجمالي 1.1 و1.2 في متطلب واحد.
2.1 مجتمعة 2.1 و2.5 في متطلب واحد.
2.2 مجتمعة 2.2 و2.3 و2.4 في متطلب واحد.
3.5 مجموع 3.5 و3.6 و3.7 في متطلب واحد.
3.10 تمت إضافة شرط بأن الإضافة لا تدخل في سياق غير مفهوم غير قابل للاسترداد.
3.11، 3.12 بإجمالي 5.5 و5.6 و6.3 و6.4 و7.5 و7.6 في مجموعتَين جديدتَين متطلبات المشروع.
4.2 تم توسيع وصف تجارب ميزة "اكتشاف المرفقات" المقبولة.
4.3 تمت إعادة الترقيم، سابقًا 4.2. تم تغييرها أيضًا من REQUIRED إلى موصى به.
4.4 مُعاد ترقيمه، كان سابقًا 4.3.
4.5 مُعاد ترقيمه، كان سابقًا 4.4.
5.2 مُعاد ترقيمه، وكان سابقًا 5.3.
5.3 تمت إعادة ترقيمه، وكان سابقًا 5.2.
9.1 تمت إضافة اقتراح لترقية الروابط التي تم لصقها إلى المرفقات.
9.2 تمت إضافة اقتراح بإنشاء مرفقات الإضافات تلقائيًا في حال إنشاء مهام CourseWork آليًا.
2.6، 3.7، 3.8، 6.2، 7.3، 7.4 تمّت إزالة الموضوع.
الإصدار 0.3 تاريخ التعديل: 22 تشرين الثاني (نوفمبر) 2022
2.3 تصحيح في إرشادات تلميح تسجيل الدخول
2.4 تم تضمين سيناريو حيث يتم تنفيذ hd مطلوبة.
3.2 تمت إعادة صياغة "توفير مسار".
5.5، 5.6، 6.3، 6.4، 7.5، 7.6 تمت إضافة نسخة من الدورة التدريبية المطلوبة والإرشادات المقترَحة studentViewUri وteacherViewUri و studentWorkReviewUri
الإصدار 0.2 تاريخ التعديل: 29 تشرين الأول (أكتوبر) 2021
1.3 تم تعديل النص ليكون أكثر وضوحًا.
3.1 تمت إضافة "يجب أن تلتزم الإضافة بالإرشادات العامة للموافقة على GWM". على موقع الويب لديهم".
3.9 تم تغيير WCAG إلى "موصى به".
5.1 تم التغيير من REQUIRED إلى "موصى به".
5.3 تمت إضافة "إذا انبثقت الإضافات من إطار iframe، يجب أن تكون هناك معاينة. حول المهمة في iframe".
5.4 تمت إضافة "إذا خرجت الإضافة من إطار iframe، فمن المفترض أن يكون هناك طلب للطلاب للعودة إلى Classroom".
8.1 تمت إضافة الرسالة "إذا كان الجهاز غير متوافق، يجب عرض رسالة المستخدم لإعلامه بأنه جهاز غير متوافق، ومن المفترض أن يكون الأجهزة المتوافقة".
8.2 تم تغيير عمل الطالب المتنقل من "مطلوب" إلى "مقترح".
الإصدار 0.1 تم التعديل في 22 أيلول (سبتمبر) 2021.
  الإصدار الأولي.