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)

פלט בלבד. גרסת טרום-ההשקה (Preview) של ה-API ששימשה לאחזור המשאב הזה.

אפשרויות ליצירת קריטריון הערכה ממקור קיים. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
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

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