REST Resource: courses.courseWork.rubrics

منبع: روبریک

عنوان کار کلاسی. سیستم نمره‌دهی راهنمای امتیازدهی است که برای ارزیابی کار محصل و ارائه بازخورد استفاده می‌شود.

برای جزئیات بیشتر، ساختار و محدودیت‌های شناخته‌شده راهنمای نمره‌دهی را ببینید.

نمایش JSON
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "creationTime": string,
  "updateTime": string,
  "criteria": [
    {
      object (Criterion)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "sourceSpreadsheetId": string
}
فیلدها
courseId

string

شناسه دوره.

فقط خواندنی.

courseWorkId

string

شناسه مربوط به تکالیف درسی که این مورد با آن مطابقت دارد.

فقط خواندنی.

id

string

شناسه اختصاص‌داده‌شده Classroom برای سیستم نمره‌دهی. این عنوان در بین عناوین مربوط به تکالیف درسی مربوطه منحصربه‌فرد است.

فقط خواندنی.

creationTime

string (Timestamp format)

فقط خروجی. مُهر زمان ایجاد این راهنمای نمره‌دهی.

فقط خواندنی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

فقط خروجی. مُهر زمان جدیدترین تغییر در این راهنمای نمره‌دهی.

فقط خواندنی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".

criteria[]

object (Criterion)

فهرست معیارها. هر معیار بعدی است که عملکرد براساس آن رتبه‌بندی می‌شود.

previewVersion

enum (PreviewVersion)

فقط خروجی. نسخه پیش‌نمایش میانای برنامه‌سازی کاربردی که برای بازیابی این منبع استفاده شده است.

گزینه‌های ایجاد راهنمای نمره‌دهی از منبع موجود. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
sourceSpreadsheetId

string

فقط ورودی. تغییرناپذیر. شناسه «کاربرگ‌نگار Google» صفحه‌گسترده. این صفحه‌گسترده باید حاوی تنظیمات قالب‌بندی‌شده راهنمای نمره‌دهی باشد. ایجاد یا استفاده مجدد از سیستم نمره‌دهی برای تکلیف را ببینید. استفاده از این فیلد به گستره https://www.googleapis.com/auth/spreadsheets.readonly یا https://www.googleapis.com/auth/spreadsheets نیاز دارد.

پایان فیلدهای متقابلاً انحصاری.

معیار

معیار سیستم نمره‌دهی. هر معیار بعدی است که عملکرد براساس آن رتبه‌بندی می‌شود.

نمایش JSON
{
  "id": string,
  "title": string,
  "description": string,
  "levels": [
    {
      object (Level)
    }
  ],
  "learningGoal": {
    object (LearningGoal)
  }
}
فیلدها
id

string

شناسه معیار.

هنگام ایجاد، شناسه‌ای اختصاص داده می‌شود.

title

string

عنوان معیار.

description

string

شرح معیار.

levels[]

object (Level)

فهرست سطوح در این معیار.

learningGoal

object (LearningGoal)

اختیاری.

«هدف یادگیری» منسوب به این معیار. توجه داشته باشید که اهداف یادگیری پیوست‌شده به معیارهای «سیستم نمره‌دهی» باید ازقبل به تکلیفی که «سیستم نمره‌دهی» به آن پیوند داده شده است پیوست شده باشند. این فیلد فقط درصورتی درج می‌شود که previewVersion مناسب تنظیم شده باشد.

سطح

سطحی از معیار.

نمایش JSON
{
  "id": string,
  "title": string,
  "description": string,
  "points": number
}
فیلدها
id

string

شناسه سطح.

هنگام ایجاد، شناسه‌ای اختصاص داده می‌شود.

title

string

عنوان سطح.

اگر برای سطح امتیازی تنظیم نشده باشد، عنوان باید تنظیم شود.

description

string

شرح سطح.

points

number

امتیازهای اختیاری مرتبط با این سطح. اگر تنظیم شود، همه سطوح در راهنمای نمره‌دهی باید امتیازها را مشخص کنند و مقدار باید در همه سطوح در یک معیار متمایز باشد. ۰ با بدون امتیاز متفاوت است.

روش‌ها

create

سیستم نمره‌دهی ایجاد می‌کند.

delete

سیستم نمره‌دهی را حذف می‌کند.

get

سیستم نمره‌دهی را برمی‌گرداند.

list

فهرستی از راهنماهای ارزیابی را که درخواست‌کننده مجاز به مشاهده آن‌ها است برمی‌گرداند.

patch

سیستم نمره‌دهی را به‌روز می‌کند.