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

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

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

يجب تفسير الكلمات الأساسية "MUST" و"MUST NOT" و"REQUIRED" و"SHALL" و"SHALL NOT" و"SHOULD" و"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. تم تغييرها أيضًا من "مطلوبة" إلى "موصى بها".
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.
	الإصدار الأولي.