ساختار روبریک و محدودیت های شناخته شده

اگر با Rubrics Classroom آشنا نیستید، به این مقالات مرکز راهنمایی مراجعه کنید تا در مورد ساختار کلی یک روبریک و نحوه درجه‌بندی روبریک در رابط کاربری Classroom بیاموزید.

ساختار روبریک

برخی از مفاهیم مهم وجود دارد که ممکن است هنگام استفاده از API برای تعامل با روبریک ها ارزش برجسته کردن را داشته باشد:

  • (حداکثر) یک روبریک منفرد مرتبط با CourseWork وجود دارد و آن روبریک منحصر به آن CourseWork است (در منابع CourseWork قابل اشتراک‌گذاری نیست).
  • روبریک شامل معیارهایی است که از سطوح تشکیل شده است. یک روبریک همیشه باید حداقل یک معیار داشته باشد و یک معیار باید حداقل یک سطح داشته باشد.
  • سطوح را می توان به ثمر رساند (دارای امتیاز) یا بدون امتیاز (بدون امتیاز). سطوح باید به طور کامل یا کاملاً بدون امتیاز در یک روبریک امتیازدهی شوند.
    • در صورت امتیازدهی به سطوح، تمام سطوح در یک معیار باید دارای یک مجموعه ارزش امتیاز منحصر به فرد باشند. نقاط می توانند اعداد صحیح (مانند 10) یا مقادیر ممیز شناور (مانند 9.99) باشند. این می تواند شامل 0 باشد. مقادیر تهی پذیرفته نمی شوند. علاوه بر این، یک روبریک نمی‌تواند یک معیار واحد با یک سطح واحد که 0 امتیاز است داشته باشد.
    • اگر سطوح بدون امتیاز باشند، قسمت امتیاز باید حذف شود. مقادیر null پذیرفته نمی شوند.
  • ترتیب معیارها و سطوح معنادار است و منعکس کننده ترتیبی است که در Classroom UI نشان داده می شوند.
    • سطوح امتیازی به ویژه باید همیشه بر اساس امتیاز به ترتیب افزایش یا کاهش مرتب شوند.
  • می تواند تا 50 معیار در هر روبریک و حداکثر 10 سطح عملکرد در هر معیار وجود داشته باشد.

اشیاء StudentSubmission از فیلدهای مرتبط با روبریک ها پشتیبانی می کنند:

  • علاوه بر ویژگی‌های draftGrade و assignedGrade موجود، یک ارسال دانش‌آموزی که با یک روبریک درجه‌بندی می‌شود، دارای ویژگی‌های draftRubricGrades و assignedRubricGrades است. اینها نمرات روبریک (سطوح انتخاب شده و مقادیر امتیاز) را نشان می دهد که دانش آموز در حین نمره دهی از عنوان، به ترتیب در حالت های پیش نویس و تعیین شده دریافت می کند.
  • در حال حاضر، این ویژگی ها فقط خواندنی هستند. این بدان معناست که از API نمی‌توان برای درجه‌بندی موارد ارسالی استفاده کرد ، اما می‌توانید موارد ارسالی را که در Classroom UI درجه‌بندی شده‌اند، بخوانید.

رفتارهای روبریک

هدف 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 حساس هستند و ممکن است نیاز به تأیید درخواست شما داشته باشند.

دوره های شخص ثالث

روبریک ها را فقط می توان توسط پروژه Google Cloud ایجاد کرد که مورد اصلی CourseWork را ایجاد کرد. این یک الگوی طراحی گسترده‌تر در Classroom API است که از تأثیرگذاری برنامه‌های مختلف بر منابع غیرقابل استفاده جلوگیری می‌کند.

این به منابع ایجاد شده توسط کاربران در برنامه Classroom گسترش می یابد. به عنوان مثال، برای یک برنامه کاربردی نمی‌توان روبریک‌های یک درس را که معلم در رابط کاربری کلاس درس ایجاد کرده است، مدیریت کرد، حتی اگر همان معلم مالک برنامه باشد. اگر این مورد استفاده شما را به میزان قابل توجهی محدود می کند، بازخورد خود را در ردیاب مشکلات عمومی به اشتراک بگذارید.

الزامات مجوز

یک کاربر تنها در صورتی می‌تواند روبریک‌ها را با API Classroom ایجاد، به‌روزرسانی و حذف کند که شرایط زیر وجود داشته باشد:

برای آشنایی بیشتر با قابلیت‌های API و پیش نیازهای Classroom API برای آشنایی و درخواست یک حساب آزمایشی برای توسعه، واجد شرایط بودن کاربر را ببینید.

قبلی
دوره های درجه بندی