الإصدار 1.1، 5 ديسمبر 2024
تنطبق المعايير الواردة في هذه الصفحة على جميع إضافات Classroom. يجب أن تستوفي الإضافة جميع العناصر المطلوبة السارية ليتمّ الموافقة على إدراجها في Google Workspace Marketplace كإضافة "متوافقة مع Classroom".
يجب تفسير الكلمات الرئيسية "يجب" و"يجب عدم" و"مطلوب" و"يجب" و"يجب عدم" و"يجب" و"يجب عدم" و"موصى به" و"يجوز" و "اختياري" الواردة في هذا المستند على النحو الموضّح في RFC 2119.
المتطلّبات
| رقم التعريف | النوع | ||
|---|---|---|---|
| 1.0 | اتفاقية ترخيص المستخدم النهائي (إذا كان ذلك منطبقًا) | ||
| 1.1 | يجب عرض رسالة سهلة الاستخدام للمستخدم عندما لا يكون لديه ترخيص. يجب أن توضّح الرسالة بوضوح سبب عدم إمكانية استخدام الإضافة وأن تقترح على المستخدم إجراءً لمعالجة المشكلة. | موصى به | |
| 1.3 | يجب أن تتضمّن بطاقة بيانات الإضافة في Google Workspace Marketplace تفاصيل حول متطلبات الترخيص والاشتراك التي قد تكون مطلوبة لاستخدام الإضافة. إذا كان للملحق مستوى مدفوع، يجب أن يوفّر بطاقة بيانات Marketplace رابطًا يؤدي إلى صفحة ويب تقدّم مزيدًا من المعلومات حول الأسعار أو كيفية التواصل مع مندوب مبيعات. | موصى به | |
| 2.0 | تسجيل دخول المستخدم النهائي | ||
| 2.1 | على مستخدمي المعلّمين تسجيل الدخول إلى الإضافة باستخدام خدمة الدخول المُوحَّد (SSO) من Google. إذا طُلب من المستخدمين من الطلاب تسجيل الدخول إلى الإضافة، عليهم تسجيل الدخول باستخدام خدمة الدخول المُوحَّد (SSO) من 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 | يجب أن يكمل المستخدم الرحلة باستخدام سير عمل الإضافة فقط، وألا ينتقل إلى سير عمل "الواجب الدراسي" أو يستخدم زر "المشاركة" في Classroom. | مطلوب | |
| 3.4 | اختيار اللغة: يجب أن تستند اللغة إلى الإعدادات المفضّلة المحلية التي يضبطها المتصفّح عند توفّرها. | موصى به | |
| 3.5 | إذا حدّدت إحدى الإضافات maxPoints، يجب أيضًا ضبط pointsEarned عندما يكمل الطالب عملية إرسال باستخدام بيانات اعتماد المعلّم المخزّنة (يُنصح بذلك) أو عندما يفتح المعلّم عملية الإرسال في إطار iframe الخاص بمراجعة عمل الطالب. |
مطلوب | |
| 3.9 | يجب أن تتوافق الإضافات مع إرشادات المستوى AA من الإصدار 2.1 من "إرشادات إتاحة محتوى الويب" (WCAG) بشأن تسهيل الاستخدام. على مطوّري الإضافات الإبلاغ بأنفسهم عن استيفاء هذا الشرط عند إرسال الإضافة، وعن استمرار توافق الإضافة مع التغييرات المستقبلية عليها. | موصى به | |
| 3.10 | يجب أن تكون أي أخطاء يواجهها المستخدم قابلة للقراءة. | موصى به | |
| 3.11 | إذا تم تشغيل studentViewUri أو teacherViewUri أو studentWorkViewUri من مهمة منسوخة أو دورة دراسية منسوخة، يجب ألا تعرض الإضافة صفحة خطأ في إطار iframe. |
مطلوب | |
| 4.0 | Attachment Discovery | ||
| 4.1 | إذا كان المرفق يتطلّب أن يرسل الطالب عمله، يجب أن يتضمّن المرفق studentWorkReviewUri ليتم التعامل معه كنوع نشاط وليس كمرفق من نوع المحتوى. |
مطلوب | |
| 4.2 | يجب أن يوفّر إطار iframe الخاص بميزة "اقتراح المرفقات" واجهة مستخدم تقدّم أحد الخيارَين التاليَين على الأقل:
|
مطلوب | |
| 4.3 | يجب أن يتمكّن المعلّم من العثور على كل المحتوى/الأنشطة المتاحة له والوصول إليها. | موصى به | |
| 4.4 | يجب أن يتمكّن المعلّم من معاينة المحتوى/النشاط قبل الالتزام بإرفاقه بالمهمة. | موصى به | |
| 4.5 | إذا كان على المعلّم إعداد محتوى/نشاط قبل أن يتمكّن من إرفاقه، يجب إكمال هذا العمل في الإطار المتضمّن. | موصى به | |
| 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 | تم تغيير الحالة من REQUIRED إلى RECOMMENDED. |
| 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. تم أيضًا تغيير الحالة من REQUIRED إلى RECOMMENDED. |
| 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 حالة الحقل من REQUIRED إلى RECOMMENDED. |
| 5.1 | تم تغيير الحالة من REQUIRED إلى RECOMMENDED. |
| 5.3 | تمت إضافة "إذا ظهرت الإضافات خارج إطار iframe، يجب أن تتضمّن معاينة للمهمة في إطار iframe". |
| 5.4 | تمت إضافة "إذا ظهرت الإضافة خارج إطار iframe، يجب أن يظهر للطلاب طلب بالعودة إلى Classroom". |
| 8.1 | تمت إضافة ما يلي: "في حال كان الجهاز غير متوافق، يجب عرض رسالة للمستخدم لإعلامه بأنّ الجهاز غير متوافق، ويُفضّل أن تتضمّن الرسالة الأجهزة المتوافقة". |
| 8.2 | تم تغيير إعداد "عمل الطلاب على الأجهزة الجوّالة" من "مطلوب" إلى "يُنصح به". |
| الإصدار 0.1 | تاريخ آخر تعديل: 22 أيلول (سبتمبر) 2021 |
| الإصدار الأوّلي. |