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

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

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

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

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

زمینه‌های ارسالی دانشجویان مرتبط

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

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

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

هدف این API این است که تا حد امکان، رابط کاربری Classroom را برای حفظ ثبات، منعکس کند، اما این می‌تواند منجر به رفتاری شود که ممکن است برای توسعه‌دهندگان ناآشنا باشد و شایان ذکر است:

• روبریک‌ها برای راهنمایی نمره‌دهی بدون محدود کردن معلمان در نظر گرفته شده‌اند. در نتیجه، یک معلم می‌تواند هنگام نمره‌دهی به یک ارائه با روبریک، موارد زیر را انجام دهد:
  • هنگام نمره‌دهی، کاملاً از دستورالعمل‌ها صرف نظر کنید.
  • صرف نظر از امتیازهای موجود در سطوح معیار، امتیازهای یک معیار را لغو کنید.
  • سطوح را فقط برای زیرمجموعه‌ای از معیارها انتخاب کنید.
  • بدون انتخاب سطح مربوطه، برای یک معیار امتیاز اختصاص دهید.
  • صرف نظر از امتیازاتی که از روبریک به دست می‌آید، امتیاز کل تکلیف را نادیده بگیرید.

علاوه بر این، این API از رفتارهایی که رابط کاربری Classroom از قبل ندارد، پشتیبانی نمی‌کند. برای مثال، این API امکان اعمال استفاده از روبریک‌ها در تکالیف یا لغو توانایی معلم برای ویرایش روبریک‌ها و ارسال‌ها را مانند امروز فراهم نمی‌کند.

محدودیت‌های حین درجه‌بندی

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

• ویرایش متن برای عناوین و توضیحات معیارها و سطوح مجاز است.
• ترتیب سطوح می‌تواند در چارچوب معیارها تغییر کند.

دامنه‌های اضافی

روبریک‌ها را می‌توان به صورت دستی برای استفاده مجدد توسط معلمان به Google Spreadsheets صادر کرد .

اگر از این صفحات گسترده یک روبریک ایجاد یا به‌روزرسانی کنید (به مثالی در راهنما مراجعه کنید)، برنامه شما باید دامنه https://www.googleapis.com/auth/spreadsheets.readonly یا https://www.googleapis.com/auth/spreadsheets را درخواست کند. توجه داشته باشید که دامنه‌های spreadsheets حساس در نظر گرفته می‌شوند و ممکن است نیاز به تأیید برنامه شما داشته باشند.

دوره‌های آموزشی شخص ثالث

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

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

الزامات مجوز

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

• به کاربری که درخواست را ارسال می‌کند، مجوز Google Workspace for Education Plus اختصاص داده شده است.
• به صاحب دوره مربوطه، مجوز Google Workspace for Education Plus اختصاص داده شده است.

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