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

الإصدار 1.0، 30 نيسان (أبريل) 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	يجب أن تستخدم الإضافة "الدخول الموحّد" (SSO) من Google لتسجيل دخول المستخدم تلقائيًا في الزيارات اللاحقة بدون عرض طلب بتسجيل الدخول. عندما لا ينتج عن تلميح تسجيل الدخول تطابق مع المستخدم الذي سجّل الدخول حاليًا، يجب أن تطلب الإضافة من المستخدم زر تسجيل الدخول وتمرير user_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.	مطلوب
	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. تم تغييرها أيضًا من "مطلوبة" إلى "موصى بها".
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.
	الإصدار الأولي