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

الإصدار 1.1، 5 كانون الأول (ديسمبر) 2024

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

يجب تفسير الكلمات الرئيسية "يجب" و"يجب ألّا" و"مطلوب" و"يجب" و"يجب ألّا" و"يُنصح" و"يُنصح ألّا" و"اختياري" و"يجوز" في هذا المستند على النحو الموضّح في RFC 2119.

المتطلبات

رقم التعريف النوع
1.0 ترخيص المستخدم النهائي (إذا كان ذلك منطبقًا)
  1.1 يجب عرض رسالة سهلة الاستخدام للمستخدم عندما لا يملك ترخيصًا. يجب أن توضّح الرسالة بوضوح سبب عدم إمكانية استخدام الإضافة وأن تقترح على المستخدم مسارًا للعمل على حلّ المشكلة. موصى به
  1.3 يجب أن تحدِّد بطاقة بيانات الإضافة على Google Workspace Marketplace تفاصيل عن متطلبات الترخيص والاشتراك التي قد تكون مطلوبة لاستخدام الإضافة. إذا كانت الإضافة تتضمّن فئة مدفوعة، يجب أن يوفّر بطاقة بيانات المتجر رابطًا يؤدي إلى صفحة ويب تتضمّن مزيدًا من المعلومات حول الأسعار أو كيفية التواصل مع أحد موظفي المبيعات. موصى به
2.0 تسجيل دخول المستخدم النهائي
  2.1 على مستخدمي المعلّمين تسجيل الدخول إلى الإضافة باستخدام خدمة "الدخول المُوحَّد من Google".
إذا طُلب من مستخدمي الطلاب تسجيل الدخول إلى الإضافة، عليهم تسجيل الدخول باستخدام خدمة "الدخول المُوحَّد من Google".
مطلوب
  2.2 يجب أن تستخدم الإضافة ميزة "تسجيل الدخول المُوحَّد" من Google لتسجيل دخول المستخدم تلقائيًا في الزيارات اللاحقة بدون عرض طلب تسجيل الدخول.
عندما لا يتطابق تلميح تسجيل الدخول مع المستخدم الذي سجّل الدخول حاليًا، يجب أن تطلب الإضافة من المستخدم استخدام زر تسجيل الدخول وأن تُرسل مَعلمة login_hint إلى مكتبة المصادقة لفلترة الحسابات غير الصالحة.
مطلوب
  2.7 عندما لا يكون مستخدم Classroom مسجّلاً الدخول إلى الإضافة (كما هو محدّد من خلال الاطّلاع على تلميح تسجيل الدخول)، يجب أن تعرض الإضافة زر "تسجيل الدخول باستخدام حساب Google" ليتمكّن المستخدم من اتخاذ إجراء صريح لبدء عملية تسجيل الدخول.
ملاحظة: هذا الإجراء ضروري لاستيفاء إرشادات وضع العلامة التجارية في Google، ويساعد أيضًا في تجنُّب حظر النوافذ المنبثقة.
مطلوب
  2.8 من المفترض أن تعرِض الإضافة المستخدم الذي سجَّل الدخول حاليًا. موصى به
3.0 الإعدادات العامة
  3.1 يجب أن تلتزم الإضافة بالإرشادات العامة للموافقة في Google Workspace Marketplace. مطلوب
  3.2 في حال بدء مهمة في علامة تبويب أو نافذة جديدة من أيّ من مسارات iframe، من المفترض أن تقدّم رسالة سهلة الاستخدام للعودة إلى Classroom. موصى به
  3.3 على المستخدم إكمال الرحلة باستخدام سير عمل الإضافة فقط وعدم التبديل إلى سير عمل courseWork أو استخدام زر المشاركة في Classroom. مطلوب
  3.4 خيار الترجمة: يجب أن تستند اللغة إلى الإعدادات المفضّلة المحلية التي يضبطها المتصفّح عند توفّرها. موصى به
  3.5 إذا كانت إحدى الإضافات تحدّد maxPoints، يجب أيضًا ضبط pointsEarned عندما يُكمل الطالب عملية إرسال باستخدام بيانات اعتماد المعلّم المخزّنة (إجراء يُنصح به) أو عندما يفتح المعلّم عملية الإرسال في إطار iframe الخاص بمراجعة عمل الطالب. مطلوب
  3.9 يجب أن تكون الإضافات متوافقة مع إرشادات المستوى AA ضمن الإصدار 2.1 من إرشادات إتاحة محتوى الويب (WCAG) بشأن إمكانية الوصول. على مطوّري الإضافات الإبلاغ ذاتيًا عن استيفاء هذا الشرط في وقت الإرسال، وأن تظل الإضافة متوافقة مع التغييرات المستقبلية التي تطرأ عليها. موصى به
  3.10 يجب أن تكون أي أخطاء يواجهها المستخدم قابلة للقراءة. موصى به
  3.11 إذا تم تشغيل 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 إذا كان الزرّ أو الرابط في النشاط يحملان التصنيف إرسال، يجب أن يؤدي ذلك إلى إرسال طلب إلى واجهة برمجة التطبيقات لإرسال عمل الطالب لمراجعته من قِبل المعلّم. مطلوب
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.1 تم التعديل في 5 كانون الأول (ديسمبر) 2024
1.1 و1.3 و3.2 و3.10 و4.4 و5.2 تم تغييرها من "مطلوب" إلى "مُقترَح".
3.12 تمّت إزالة الموضوع.
5.3 تمت إعادة الصياغة. يتيح تغيير تم إجراؤه مؤخرًا لمطوّري الإضافات إرسال ملفاتهم بأمان التي أرسلها الطلاب باستخدام واجهة برمجة التطبيقات.
الإصدار 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. تم أيضًا تغييرها من "مطلوب" إلى "مُقترَح".
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 تم تغيير "مطلوب" إلى "مُقترَح".
5.3 تمت إضافة "إذا كانت الإضافات تظهر خارج إطار iframe، يجب أن تتوفّر معاينة عن المهمة في إطار iframe".
5.4 تمت إضافة "إذا ظهرت الإضافة خارج إطار iframe، من المفترض أن يظهر طلب للطلاب للعودة إلى Classroom".
8.1 تمت إضافة "إذا كان الجهاز غير متوافق، يجب عرض رسالة للمستخدم لإعلامه بأنّه جهاز غير متوافق، ومن الأفضل إعلامه بالأجهزة المتوافقة".
8.2 تم تغيير حالة "أعمال الطلاب على الأجهزة الجوّالة" من "مطلوب" إلى "مُقترَح".
الإصدار 0.1 تاريخ التعديل: 22 أيلول (سبتمبر) 2021
  الإصدار الأولي