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 ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 שונה מ'אין נקודות'.

Methods

create

יוצר קריטריון הערכה.

delete

מחיקת קריטריון הערכה.

get

מחזירה קריטריון להערכה.

list

הפונקציה מחזירה רשימה של קריטריונים שהשולח מורשה לצפות בהם.

patch

עדכון קריטריון הערכה.