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

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

فقط خواندنی.

creationTime

string ( Timestamp format)

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

فقط خواندنی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 )

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

فیلد اتحادیه rubric_source . گزینه‌هایی برای ایجاد یک روبریک از یک منبع موجود. rubric_source فقط می‌تواند یکی از موارد زیر باشد:
sourceSpreadsheetId

string

فقط ورودی. تغییرناپذیر. شناسه صفحات گسترده گوگل (Google Sheets) صفحه گسترده. این صفحه گسترده باید حاوی تنظیمات روبریک قالب‌بندی شده باشد. به ایجاد یا استفاده مجدد از روبریک برای یک تکلیف مراجعه کنید. استفاده از این فیلد نیاز به دامنه 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

امتیازهای اختیاری مرتبط با این سطح. در صورت تنظیم، تمام سطوح درون روبریک باید امتیازها را مشخص کنند و مقدار باید در تمام سطوح درون یک معیار واحد متمایز باشد. 0 متمایز از هیچ امتیازی نیست.

روش‌ها

create

 یک روبریک ایجاد می‌کند.

delete

 یک روبریک را حذف می‌کند.

get

 یک روبریک (robrik) برمی‌گرداند.

list

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

patch

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