- מקור מידע: קורס
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings
- CalculationType
- DisplaySetting
- שיטות
מקור מידע: קורס
קורס ב-Classroom.
ייצוג JSON |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
שדות | |
---|---|
id |
המזהה של הקורס הזה שהוקצה על ידי Classroom. כאשר ציון השדה הזה במסכה של עדכון בקורסים גורם לשגיאה. |
name |
שם הקורס. לדוגמה, 'ביולוגיה של כיתה י''. חובה להזין שם. אורך התו צריך להיות בין 1 ל-750 תווים ולהיות מחרוזת UTF-8 חוקית. |
section |
החלק בקורס. לדוגמה, 'תקופה 2'. אם השדה הזה מוגדר, השדה הזה חייב להיות מחרוזת UTF-8 חוקית ולא יותר מ-2800 תווים. |
descriptionHeading |
כותרת אופציונלית לתיאור. לדוגמה, "ברוכים הבאים לביולוגיה בכיתה י'". אם השדה הזה מוגדר, השדה הזה חייב להיות מחרוזת UTF-8 חוקית באורך של עד 3600 תווים. |
description |
תיאור אופציונלי. לדוגמה, "נלמד על המבנה של יצורים חיים משילוב של ספרי לימוד, הרצאות אורחים ועבודות במעבדה. יש ממה להתרגש!" אם השדה הזה מוגדר, השדה הזה חייב להיות מחרוזת UTF-8 חוקית באורך של עד 30,000 תווים. |
room |
מיקום החדר (אופציונלי). לדוגמה, "301". אם השדה הזה מוגדר, השדה הזה חייב להיות מחרוזת UTF-8 חוקית ולא יותר מ-650 תווים. |
ownerId |
המזהה של הבעלים של הקורס. אם השדה הזה מוגדר כפרמטר של
צריך להגדיר זאת בבקשת היצירה. אדמינים יכולים גם לציין את השדה הזה ב- |
creationTime |
זמן יצירת הקורס. ציון השדה הזה במסכה של עדכון בקורסים גורם לשגיאה. קריאה בלבד. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
updateTime |
מועד העדכון האחרון של הקורס הזה. ציון השדה הזה במסכה של עדכון בקורסים גורם לשגיאה. קריאה בלבד. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
enrollmentCode |
קוד הרשמה לשימוש בהצטרפות לקורס הזה. ציון השדה הזה במסכה של עדכון בקורסים גורם לשגיאה. קריאה בלבד. |
courseState |
מצב הקורס. אם לא צוין מצב ברירת המחדל, מצב ברירת המחדל הוא |
alternateLink |
קישור מוחלט לקורס הזה בממשק המשתמש של Classroom באינטרנט. קריאה בלבד. |
teacherGroupEmail |
כתובת האימייל של קבוצת Google שמכילה את כל המורים של הקורס. קבוצה זו לא מקבלת אימיילים וניתן להשתמש בה רק להרשאות. קריאה בלבד. |
courseGroupEmail |
כתובת האימייל של קבוצת Google שמכילה את כל המשתתפים בקורס. קבוצה זו לא מקבלת אימיילים וניתן להשתמש בה רק להרשאות. קריאה בלבד. |
teacherFolder |
מידע על תיקיית Drive שמשותפת עם כל המורים בקורס. השדה הזה יוגדר רק למורים של הקורס ולמנהלי הדומיין. קריאה בלבד. |
courseMaterialSets[] |
קבוצות של חומרים שמופיעים בדף 'מידע כללי' בקורס הזה. קריאה בלבד. |
guardiansEnabled |
האם האפשרות לשלוח התראות לאפוטרופוסים מופעלת בקורס הזה או לא. קריאה בלבד. |
calendarId |
מזהה היומן של יומן שכל משתתפי הקורס יכולים לראות, שאליו מתווספים אירועים של העבודות בקורס והכרזות בקורסים. היומן של קורס נוצר באופן אסינכרוני כשהקורס מוגדר בפעם הראשונה לערך קריאה בלבד. |
gradebookSettings |
ההגדרות של גיליון הציונים שמציינות איך יחושב הציון הכולל של התלמיד/ה בקורס, ולמי הוא יוצג. קריאה-בלבד |
CourseState
מצבים אפשריים שבהם יכול להשתתף בקורס.
טיפוסים בני מנייה (enums) | |
---|---|
COURSE_STATE_UNSPECIFIED |
אין מצב קורס. אף הודעה שהוחזרה בקורס לא תשתמש בערך הזה. |
ACTIVE |
הקורס פעיל. |
ARCHIVED |
הקורס הועבר לארכיון. לא ניתן לשנות אותו אלא לשנות את הסטטוס שלו. |
PROVISIONED |
הקורס נוצר, אבל עדיין לא הופעל. למורה הראשי ולמנהלי הדומיין יש גישה לטופס, והם יכולים לשנות אותו למצב ACTIVE או למצב DECLINED . ניתן לשנות קורס בקורס PROVISIONED רק אם הוא נמצא במצב DECLINED . |
DECLINED |
הקורס נוצר, אבל הבקשה נדחתה. בעלי הקורס ומנהלי הדומיין יכולים לגשת אליו, אם כי הוא לא יוצג בממשק המשתמש באינטרנט. לא ניתן לשנות את הקורס אלא לשנות אותו למצב PROVISIONED . ניתן לשנות קורס בקורס DECLINED רק אם הוא נמצא במצב PROVISIONED . |
SUSPENDED |
הקורס הושעה. לא ניתן לשנות את הקורס, ורק המשתמש שזוהה ב-ownerId יכול לצפות בקורס. קורס יכול להיות ממוקם במצב הזה אם הוא מפר באופן פוטנציאלי את התנאים וההגבלות. |
CourseMaterialSet
קבוצת חומרים שמופיעים בדף 'מידע כללי' של הקורס. החומרים האלה עשויים לכלול תוכנית לימודים, לוח זמנים או פרטי רקע אחרים שקשורים לקורס כולו.
ייצוג JSON |
---|
{
"title": string,
"materials": [
{
object ( |
שדות | |
---|---|
title |
שם הקבוצה הזו. |
materials[] |
החומרים שמצורפים לקבוצה הזו. |
CourseMaterial
חומר שמצורף לקורס כחלק מקבוצת חומרים.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד material . נתוני חומר לימוד. הערך של material יכול להיות רק אחת מהאפשרויות הבאות: |
|
driveFile |
קובץ מצורף מ-Google Drive. |
youTubeVideo |
קובץ מצורף של סרטון ב-YouTube. |
link |
להגדרה של קישור. |
form |
קובץ מצורף מ-Google Forms. |
GradebookSettings
ההגדרות של גיליון הציונים בקורס. פרטים נוספים זמינים במאמר במרכז העזרה.
ייצוג JSON |
---|
{ "calculationType": enum ( |
שדות | |
---|---|
calculationType |
ציון האופן שבו מחושב הציון הכולל. |
displaySetting |
שדה זה מציין מי יכול לראות את הציון הכולל. |
gradeCategories[] |
קטגוריות הציונים שזמינות לעבודות בקורס. |
CalculationType
שיטות אפשריות לחישוב הציון הכולל.
טיפוסים בני מנייה (enums) | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
לא צוינה שיטה. המידע הזה לא מוחזר אף פעם. |
TOTAL_POINTS |
הציון הכולל הוא סכום הציונים חלקי סכום הנקודות הכולל, ללא קשר לקטגוריה. |
WEIGHTED_CATEGORIES |
הציון הכולל הוא הממוצע המשוקלל לפי קטגוריה. |
DisplaySetting
הגדרות אפשריות להצגת הציון הכולל.
טיפוסים בני מנייה (enums) | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
לא צוינו הגדרה. המידע הזה לא מוחזר אף פעם. |
SHOW_OVERALL_GRADE |
הצגת הציון הכולל בגיליון הציונים ובפרופיל התלמיד, למורים ולתלמידים. |
HIDE_OVERALL_GRADE |
לא מוצגת הציון הכולל בגיליון הציונים או בפרופיל התלמיד. |
SHOW_TEACHERS_ONLY |
הצגת הציון הכולל למורים בגיליון הציונים ובפרופיל התלמיד. הסתרה מהתלמידים בפרופיל התלמיד/ה. |
שיטות |
|
---|---|
|
מחזירה אם משתמש עומד בדרישות ליצירת קבצים מצורפים של תוספים בקורס נתון. |
|
יצירת קורס. |
|
מוחק קורס. |
|
מחזירה קורס. |
|
מחזירה רשימה של קורסים שהמשתמש ששלח את הבקשה מורשה לצפות בהם, המוגבלים לקורסים התואמים לבקשה. |
|
עדכון שדה אחד או יותר בקורס. |
|
עדכון קורס. |