الإصدار 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 للإضافة تفاصيل حول متطلبات الترخيص التي قد تكون مطلوبة لاستخدام الإضافة. إذا كانت الإضافة تحتوي على فئة مدفوعة، يجب أن توفّر بطاقة بيانات Marketplace رابطًا إلى صفحة ويب توفّر المزيد من المعلومات حول الأسعار أو كيفية التواصل مع مندوب مبيعات. | مطلوب | |
| 2.0 | تسجيل دخول المستخدم | ||
| 2.1 | على مستخدمي المعلّمين تسجيل الدخول إلى الإضافة باستخدام خدمة الدخول المُوحَّد (SSO) من Google. إذا طُلب من المستخدمين من الطلاب تسجيل الدخول إلى الإضافة، عليهم تسجيل الدخول باستخدام الدخول المُوحَّد (SSO) من Google. |
مطلوب | |
| 2.2 | يجب أن تستخدم الإضافة خدمة الدخول المُوحَّد (SSO) من Google لتسجيل دخول المستخدم تلقائيًا في الزيارات اللاحقة بدون عرض طلب لتسجيل الدخول. عندما لا يتطابق تلميح تسجيل الدخول مع المستخدم الذي تم تسجيل الدخول إليه حاليًا، يجب أن تطلب الإضافة من المستخدم باستخدام زر تسجيل الدخول وتُمرِّر تلميح تسجيل الدخول إلى مكتبة المصادقة لفلترة الحسابات غير الصالحة. |
مطلوب | |
| 2.7 | إذا لم يسبق لمستخدم Classroom تسجيل الدخول إلى الإضافة (كما هو محدَّد من خلال الاطّلاع على تلميح تسجيل الدخول)، يجب أن تعرض الإضافة زر "تسجيل الدخول باستخدام حساب Google" ليطلب من المستخدم بدء عملية تسجيل الدخول. ملاحظة: هذا الإجراء ضروري لتجنّب ظهور إرشادات علامة Google التجارية ويساعد أيضًا في تجنّب النوافذ المنبثقة. |
مطلوب | |
| 2.8 | "ينبغي" أن تعرض الإضافة هوية المستخدم الذي سجّل الدخول حاليًا. | موصى به | |
| 3.0 | الإعدادات العامة | ||
| 3.1 | يجب أن تتقيّد الإضافة بالإرشادات العامة للموافقة على Google Workspace Marketplace. | مطلوب | |
| 3.2 | في حال إطلاق مَهمّة في علامة تبويب أو نافذة جديدة من أيّ من رحلات iframe، يجب أن تقدّم رسالة سهلة الاستخدام للرجوع إليها إلى Classroom. | مطلوب | |
| 3.3 | على المستخدم إكمال الرحلة باستخدام سير عمل إضافة فقط، وعدم الانتقال إلى مسار الدورة التدريبية Work أو استخدام "زر المشاركة" في 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 إلى RECOMMENDED. |
| 5.1 | تم تغيير required إلى RECOMMENDED. |
| 5.3 | تمت إضافة الرسالة "إذا انبثقت الإضافات من إطار iframe، يجب أن تتوفر معاينة للمهمة في iframe". |
| 5.4 | تمت إضافة رسالة مفادها: "إذا انبثقت الإضافة من إطار iframe، يجب أن تظهر رسالة تطلب من الطلاب العودة إلى Classroom". |
| 8.1 | تمت إضافة الرسالة "إذا كان الجهاز غير متوافق، يجب عرض رسالة للمستخدم لإعلامه بأنه غير متوافق، ومن الأفضل تحديد الأجهزة المتوافقة". |
| 8.2 | تم تغيير عمل الطالب المتنقل من "مطلوب" إلى "مُوصى به". |
| الإصدار 0.1 | تاريخ التعديل: 22 أيلول (سبتمبر) 2021 |
| الإصدار الأولي. |