REST Resource: courses

משאב: קורס

קורס ב-Classroom.

ייצוג JSON 
{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  }
}
שדות
id

string

המזהה של הקורס הזה שהוקצה על ידי Classroom.

כשהערך הוא creating a course, אפשר להגדיר את המזהה הזה כ-alias string בבקשה ליצירת כינוי תואם. ה-id עדיין מוקצה על ידי Classroom ואי אפשר לעדכן אותו אחרי יצירת הקורס.

ציון השדה הזה במסכה לעדכון קורס יוביל לשגיאה.
name

string

שם הקורס. לדוגמה, 'ביולוגיה כיתה י'. חובה להזין שם. המזהה צריך להיות באורך של 1 עד 750 תווים, והוא צריך להכיל מחרוזת UTF-8 חוקית.
section

string

קטע בקורס. לדוגמה, 'מחצית שנה 2'. אם השדה הזה מוגדר, הוא חייב להיות מחרוזת UTF-8 תקינה באורך של עד 2,800 תווים.
descriptionHeading

string

כותרת אופציונלית לתיאור. לדוגמה, "ברוכים הבאים לביולוגיה לכיתה י'". אם השדה מוגדר, הוא צריך להיות מחרוזת UTF-8 תקינה באורך של עד 3,600 תווים.
description

string

תיאור אופציונלי. לדוגמה, "נלמד על המבנה של יצורים חיים משילוב של ספרי לימוד, הרצאות אורח ועבודות במעבדה. זה הולך להיות מעניין!" אם השדה הזה מוגדר, הוא חייב להיות מחרוזת UTF-8 תקינה באורך של עד 30,000 תווים.
room

string

מיקום אופציונלי של החדר. לדוגמה, '301'. אם השדה מוגדר, הוא חייב להיות מחרוזת UTF-8 תקינה באורך של עד 650 תווים.
ownerId

string

המזהה של הבעלים של קורס.

כשהשדה מצוין כפרמטר של create course request, הוא חובה. המזהה יכול להיות אחד מהבאים:

  • המזהה המספרי של המשתמש
  • כתובת האימייל של המשתמש
  • מחרוזת הליבה "me", שמציינת את המשתמש ששלח את הבקשה

צריך להגדיר את הערך הזה בבקשת יצירה. אדמינים יכולים גם לציין את השדה הזה ב-patch course request כדי להעביר את הבעלות. בהקשרים אחרים, הוא לקריאה בלבד.
creationTime

string (Timestamp format)

מועד היצירה של הקורס. ציון השדה הזה במסכת עדכון של קורס גורם לשגיאה.

קריאה בלבד.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

מועד העדכון האחרון של הקורס. ציון השדה הזה במסכת עדכון של קורס גורם לשגיאה.

קריאה בלבד.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
enrollmentCode

string

קוד ההרשמה לשימוש כשמצטרפים לקורס הזה. ציון השדה הזה במסכת עדכון של קורס גורם לשגיאה.

קריאה בלבד.
courseState

enum (CourseState)

מצב הקורס. אם לא צוין מצב, מצב ברירת המחדל הוא PROVISIONED.
teacherGroupEmail

string

כתובת האימייל של קבוצה ב-Google שמכילה את כל מורים של הקורס. הקבוצה הזו לא מקבלת אימיילים וניתן להשתמש בה רק להרשאות.

קריאה בלבד.
courseGroupEmail

string

כתובת האימייל של קבוצת Google שמכילה את כל חברי הקורס. אי אפשר לשלוח אימייל לקבוצה הזו, והיא משמשת רק להענקת הרשאות.

קריאה בלבד.
teacherFolder

object (DriveFolder)

מידע על תיקייה ב-Drive ששותפה עם כל המורים בקורס.

השדה הזה יוגדר רק למורים של הקורס ולמנהלי דומיינים.

קריאה בלבד.
courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

קבוצות של חומרי לימוד שמופיעות בדף 'מידע על הקורס'.

קריאה בלבד.
guardiansEnabled

boolean

אם ההתראות להורים מופעלות בקורס הזה או לא.

קריאה בלבד.
calendarId

string

מזהה היומן של יומן שכל משתתפי הקורס יכולים לראות, שאליו מערכת Classroom מוסיפה אירועים לעבודות בקורס והודעות לכיתה.

לוח השנה של הקורס נוצר באופן אסינכררוני כשהקורס מוגדר ל-CourseState.ACTIVE בפעם הראשונה (בזמן היצירה או כשהוא מעודכן ל-ACTIVE דרך ממשק המשתמש או ה-API). מזהה היומן לא יאוכלס עד שתהליך היצירה יושלם.

קריאה בלבד.
gradebookSettings

object (GradebookSettings)

הגדרות של גיליון הציונים שמציינות איך יחושב הציון הכולל של התלמיד בקורס, ולמי הוא יוצג.

קריאה בלבד

CourseState

המצבים האפשריים של קורס.

טיפוסים בני מנייה (enum)
COURSE_STATE_UNSPECIFIED אין מצב קורס. הערך הזה לא ישמש אף הודעה לגבי הקורס.
ACTIVE הקורס פעיל.
ARCHIVED הקורס הועבר לארכיון. לא ניתן לשנות אותו, אלא רק להעביר אותו למצב אחר.
PROVISIONED הקורס נוצר, אבל עדיין לא הופעל. רק המורה הראשי ואדמינים של דומיינים יכולים לגשת אליו, והם יכולים לשנות אותו או להעביר אותו למצבים ACTIVE או DECLINED. אפשר לשנות קורס ל-PROVISIONED רק אם הוא נמצא במצב DECLINED.
DECLINED הקורס נוצר, אבל נדחה. הבעלים של הקורס ומנהלי הדומיין יכולים לגשת אליו, אבל הוא לא יוצג בממשק המשתמש באינטרנט. לא ניתן לשנות את הקורס, אלא רק להעביר אותו למצב PROVISIONED. אפשר לשנות קורס ל-DECLINED רק אם הוא נמצא במצב PROVISIONED.
SUSPENDED הקורס הושעה. לא ניתן לשנות את הקורס, ורק המשתמש שצוין ב-ownerId יכול לצפות בו. יכול להיות שקורס יועבר למצב הזה אם יש חשד שהוא מפר את התנאים וההגבלות.

CourseMaterialSet

קבוצת חומרים שמופיעה בדף 'מידע על הקורס'. החומרים האלה יכולים לכלול תוכנית לימודים, לוח זמנים או מידע רקע אחר שקשור לקורס כולו.

ייצוג ב-JSON 
{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}
שדות
title

string

שם הקבוצה.
materials[]

object (CourseMaterial)

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

CourseMaterial

חומר לימוד שמצורף לקורס כחלק מקבוצת חומרים.

ייצוג JSON 
{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}
שדות
שדה האיחוד material. נתונים מהותיים. material יכול להיות רק אחת מהאפשרויות הבאות:
driveFile

object (DriveFile)

צירוף קובץ מ-Google Drive.
youTubeVideo

object (YouTubeVideo)

צירוף סרטון מ-YouTube.
form

object (Form)

קובץ מצורף מ-Google Forms.

GradebookSettings

ההגדרות של גיליון הציונים בקורס. פרטים נוספים זמינים במאמר הזה במרכז העזרה.

ייצוג JSON 
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
שדות
calculationType

enum (CalculationType)

מציין את אופן החישוב של הציון הכולל.
displaySetting

enum (DisplaySetting)

כאן מציינים מי יוכל לראות את הציון הכולל.
gradeCategories[]

object (GradeCategory)

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

CalculationType

שיטות אפשריות לחישוב הציון הכולל.

טיפוסים בני מנייה (enum)
CALCULATION_TYPE_UNSPECIFIED לא צוינה שיטה. הערך הזה לא מוחזר אף פעם.
TOTAL_POINTS הציון הכולל הוא סכום הציונים חלקי סכום הנקודות הכולל, ללא קשר לקטגוריה.
WEIGHTED_CATEGORIES הציון הכולל הוא הממוצע המשוקלל לפי קטגוריה.

DisplaySetting

הגדרות אפשריות להצגת הציון הכולל.

טיפוסים בני מנייה (enum)
DISPLAY_SETTING_UNSPECIFIED לא צוינה הגדרה. הערך הזה אף פעם לא מוחזר.
SHOW_OVERALL_GRADE הציון הכולל מוצג בגיליון הציונים ובפרופיל התלמיד/ה גם למורים וגם לתלמידים.
HIDE_OVERALL_GRADE הציון הכולל לא מוצג בגיליון הציונים או בפרופיל התלמיד/ה.
SHOW_TEACHERS_ONLY הציון הכולל מוצג למורים בגיליון הציונים ובפרופיל התלמיד/ה. מוסתר מהתלמידים בפרופיל התלמיד/ה שלהם.

שיטות

checkAddOnCreationEligibility
(deprecated)

 הפונקציה מחזירה אם משתמש מסוים זכאי ליצור קבצים מצורפים של תוספים בקורס נתון.

checkGradingPeriodsSetupEligibility
(deprecated)

 הפונקציה מחזירה אם משתמש מסוים זכאי לעדכן את הגדרות תקופות המטלות בקורס נתון.

create

 יצירת קורס.

delete

 מחיקה של קורס.

get

 מחזירה קורס.

getGradingPeriodSettings

 הפונקציה מחזירה את ההגדרות של תקופות למתן ציונים בקורס.

list

 הפונקציה מחזירה רשימה של קורסים שהמשתמש המבקש מורשה להציג, ומוגבלת לקורסים שתואמים לבקשה.

patch

 עדכון של שדה אחד או יותר בקורס.

update

 עדכון קורס.

updateGradingPeriodSettings

 עדכון ההגדרות של תקופות למתן ציונים בקורס.