اگر با Rubrics Classroom آشنا نیستید، به این مقالات مرکز راهنمایی مراجعه کنید تا در مورد ساختار کلی یک روبریک و نحوه درجهبندی روبریک در رابط کاربری Classroom بیاموزید.
ساختار روبریک
برخی از مفاهیم مهم وجود دارد که ممکن است هنگام استفاده از API برای تعامل با روبریک ها ارزش برجسته کردن را داشته باشد:
- (حداکثر) یک روبریک منفرد مرتبط با
CourseWork
وجود دارد و آن روبریک منحصر به آنCourseWork
است (در منابعCourseWork
قابل اشتراکگذاری نیست). - روبریک شامل معیارهایی است که از سطوح تشکیل شده است. یک روبریک همیشه باید حداقل یک معیار داشته باشد و یک معیار باید حداقل یک سطح داشته باشد.
- سطوح را می توان به ثمر رساند (دارای امتیاز) یا بدون امتیاز (بدون امتیاز). سطوح باید به طور کامل یا کاملاً بدون امتیاز در یک روبریک امتیازدهی شوند.
- در صورت امتیازدهی به سطوح، تمام سطوح در یک معیار باید دارای یک مجموعه ارزش امتیاز منحصر به فرد باشند. نقاط می توانند اعداد صحیح (مانند 10) یا مقادیر ممیز شناور (مانند 9.99) باشند. این می تواند شامل 0 باشد. مقادیر تهی پذیرفته نمی شوند. علاوه بر این، یک روبریک نمیتواند یک معیار واحد با یک سطح واحد که 0 امتیاز است داشته باشد.
- اگر سطوح بدون امتیاز باشند، قسمت امتیاز باید حذف شود. مقادیر null پذیرفته نمی شوند.
- ترتیب معیارها و سطوح معنادار است و منعکس کننده ترتیبی است که در Classroom UI نشان داده می شوند.
- سطوح امتیازی به ویژه باید همیشه بر اساس امتیاز به ترتیب افزایش یا کاهش مرتب شوند.
- می تواند تا 50 معیار در هر روبریک و حداکثر 10 سطح عملکرد در هر معیار وجود داشته باشد.
زمینه های ارسال دانشجوی مرتبط
اشیاء ارسالی دانشجو نیز در حال تغییر هستند:
- علاوه بر ویژگیهای
draftGrade
وassignedGrade
موجود، یک ارسال دانشآموزی که با یک روبریک درجهبندی میشود، دارای ویژگیهایdraftRubricGrades
وassignedRubricGrades
است. اینها نمرات روبریک (سطوح انتخاب شده و مقادیر امتیاز) را نشان می دهد که دانش آموز در حین نمره دهی از عنوان، به ترتیب در حالت های پیش نویس و تعیین شده دریافت می کند. - در حال حاضر، این ویژگی ها فقط خواندنی هستند. این بدان معناست که از API نمیتوان برای درجهبندی موارد ارسالی استفاده کرد ، اما میتوانید موارد ارسالی را که در Classroom UI درجهبندی شدهاند، بخوانید.
- ارسالهای دانشآموز با روبریک مرتبط حاوی یک فیلد
rubricId
است. این فیلد جدیدترین روبریک مرتبط باCourseWork
را نشان میدهد و اگر معلمان یک روبریک را حذف و دوباره ایجاد کنند، ممکن است این مقدار تغییر کند.
رفتارهای روبریک
هدف API این است که هر زمان که ممکن است برای یکپارچگی، رابط کاربری کلاس را منعکس کند، اما این میتواند منجر به رفتارهایی شود که ممکن است برای توسعهدهندگان غیرمعمول باشد و قابل ذکر است:
- روبریک ها برای راهنمایی درجه بندی بدون محدودیت معلمان در نظر گرفته شده اند. در نتیجه، یک معلم میتواند هنگام نمرهدهی یک مقاله با یک روبریک، موارد زیر را انجام دهد:
- هنگام نمره دهی به طور کامل از روبریک چشم پوشی کنید.
- بدون توجه به امتیازات موجود در سطوح معیار، امتیازات را نادیده بگیرید.
- سطوح را فقط برای زیر مجموعه ای از معیارها انتخاب کنید.
- امتیاز برای یک معیار بدون انتخاب سطح مربوطه اختصاص دهید.
- کل امتیازهای تکلیف را صرف نظر از امتیازهایی که از عنوان به دست میآیند، لغو کنید.
علاوه بر این، API هیچ قابلیت محصول جدیدی را معرفی نمی کند. به عبارت دیگر، API از رفتاری که Classroom UI قبلاً نداشته است پشتیبانی نمیکند . به عنوان مثال، API استفاده از روبریکها را در تکالیف یا نادیده گرفتن توانایی معلم برای ویرایش روبریکها و مطالب ارسالی آنطور که امروز میتواند، فعال نمیکند.
محدودیت در حین درجه بندی
به طور مشابه، هنگامی که معلم شروع به نمرهدهی با آنها کرد، محدودیتهای اضافی برای ویرایش روبریکها وجود دارد. تنها ویرایشهای زیر پس از درجهبندی در آغاز امکانپذیر است:
- ویرایش متن برای عناوین و توضیحات معیارها و سطوح مجاز است.
- ترتیب سطح می تواند در معیارها تغییر کند.
دامنه های اضافی
روبریک ها را می توان به صورت دستی برای استفاده مجدد توسط معلمان به Google Spreadsheets صادر کرد .
اگر از این صفحهگستردهها روبریکی ایجاد یا بهروزرسانی میکنید ( نمونهای را در راهنما ببینید)، برنامه شما باید https://www.googleapis.com/auth/spreadsheets.readonly
یا https://www.googleapis.com/auth/spreadsheets
درخواست کند. https://www.googleapis.com/auth/spreadsheets
دامنه. توجه داشته باشید که حوزههای spreadsheets
حساس هستند و ممکن است نیاز به تأیید درخواست شما داشته باشند.