REST Resource: courses

{
  "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)
  }
}

string

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

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

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

string

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

string

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

string

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

string

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

string

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

string

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

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

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

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

string (Timestamp format)

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

קריאה בלבד.

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

string (Timestamp format)

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

קריאה בלבד.

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

string

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

קריאה בלבד.

enum (CourseState)

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

string

קישור מוחלט לקורס הזה בממשק המשתמש האינטרנטי של Classroom.

קריאה בלבד.

string

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

קריאה בלבד.

string

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

קריאה בלבד.

object (DriveFolder)

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

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

קריאה בלבד.

object (CourseMaterialSet)

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

קריאה בלבד.

boolean

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

קריאה בלבד.

string

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

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

קריאה בלבד.

object (GradebookSettings)

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

קריאה בלבד

{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}

string

הכותרת של הקבוצה.

object (CourseMaterial)

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

{

  // 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.
}

object (DriveFile)

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

object (YouTubeVideo)

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

object (Link)

צירוף קישור.

object (Form)

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

{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}

enum (CalculationType)

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

enum (DisplaySetting)

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

object (GradeCategory)

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