نسخه 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 SSO وارد افزونه شوند. اگر از کاربران دانش‌آموز خواسته می‌شود که به افزونه وارد شوند، باید با استفاده از Google SSO وارد سیستم شوند. | ضروری | |
| 2.2 | این افزونه باید از Google SSO برای ورود خودکار کاربر در بازدیدهای بعدی بدون نمایش درخواست ورود استفاده کند. هنگامی که راهنمایی ورود به سیستم با کاربر وارد شده فعلی مطابقت ندارد، افزونه باید از کاربر یک دکمه ورود به سیستم را بخواهد و login_hint را به کتابخانه auth ارسال کند تا حساب‌های نامعتبر را فیلتر کند. | ضروری | |
| 2.7 | هنگامی که کاربر Classroom از قبل وارد برافزا نشده است (همانطور که با نگاه کردن به راهنمایی ورود مشخص می‌شود)، برافزا باید دکمه «ورود به سیستم با Google» را برای اقدام صریح کاربر برای شروع فرآیند ورود ارائه کند. توجه : این برای رعایت دستورالعمل‌های برندینگ گوگل ضروری است و همچنین به جلوگیری از مسدودکننده‌های بازشو کمک می‌کند. | ضروری | |
| 2.8 | افزونه باید نشان دهد که کاربر وارد شده فعلی چه کسی است. | توصیه شده | |
| 3.0 | عمومی | ||
| 3.1 | این افزونه باید از دستورالعمل‌های عمومی تأیید Google Workspace Marketplace پیروی کند. | ضروری | |
| 3.2 | اگر یک کار در یک برگه یا پنجره جدید از هر یک از سفرهای iframe راه اندازی شود، باید یک پیام کاربرپسند برای بازگشت به Classroom ارائه دهد. | ضروری | |
| 3.3 | کاربر باید سفر را فقط با استفاده از یک گردش کار افزودنی تکمیل کند و به جریان کار درسی تغییر ندهد یا از دکمه اشتراک‌گذاری کلاس درس استفاده نکند. | ضروری | |
| 3.4 | انتخاب محلی سازی: زبان باید بر اساس اولویت محلی تنظیم شده توسط مرورگر در صورت موجود بودن باشد. | توصیه شده | |
| 3.5 | اگر یک افزونه maxPoints را تعریف می‌کند، باید pointsEarned نیز تعیین کند که دانش‌آموز یک ارسال را با استفاده از اعتبارنامه‌های ذخیره شده معلم (توصیه می‌شود) تکمیل می‌کند یا زمانی که معلم ارسال را در iframe Student Work Review باز می‌کند. | ضروری | |
| 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 | ضمیمه Discovery 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 فعال کند. پیمایش بین دانش‌آموزان باید فقط در UI Classroom انجام شود. | ضروری | |
| 8.0 | پشتیبانی سیار کلاس درس | ||
| 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. همچنین از 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 | کار دانشجویی سیار از REQUIRED به RECOMMENDED تغییر کرد. |
| نسخه 0.1 | به روز شده در 22 سپتامبر 2021 |
| انتشار اولیه. |