REST Resource: courses.courseWork

משאב: CourseWork

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

ייצוג JSON
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}
שדות
courseId

string

מזהה הקורס.

קריאה בלבד.

id

string

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

קריאה בלבד.

title

string

שם העבודה הזו. הכותרת צריכה להיות מחרוזת UTF-8 חוקית שמכילה בין 1 ל-3,000 תווים.

description

string

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

materials[]

object (Material)

חומרים נוספים.

ב-CourseWork יש לכלול 20 חומרי לימוד לכל היותר.

state

enum (CourseWorkState)

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

creationTime

string (Timestamp format)

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

קריאה בלבד.

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

updateTime

string (Timestamp format)

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

קריאה בלבד.

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

dueDate

object (Date)

תאריך אופציונלי (לפי שעון UTC) שבו יש להגיש את העבודה בקורס הזה. צריך לציין את זה אם מציינים dueTime.

dueTime

object (TimeOfDay)

שעה אופציונלית ביום, לפי שעון UTC, שבה צריך להגיש את העבודה בקורס הזה. צריך לציין את זה אם מציינים dueDate.

scheduledTime

string (Timestamp format)

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

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

maxPoints

number

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

workType

enum (CourseWorkType)

סוג העבודה הזו.

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

associatedWithDeveloper

boolean

אם פריט העבודה בקורס משויך לפרויקט ב-Developer Console שממנו נשלחה הבקשה.

אתה יכול לראות עוד פרטים בכתובת courseWork.create.

קריאה בלבד.

assigneeMode

enum (AssigneeMode)

מצב ההקצאה של העבודה. אם לא צוין ערך, ערך ברירת המחדל הוא ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

מזהי תלמידים שיש להם גישה לעבודות הקורס. השדה הזה מוגדר רק אם הערך של assigneeMode הוא INDIVIDUAL_STUDENTS. אם הערך של assigneeMode הוא INDIVIDUAL_STUDENTS, רק התלמידים שצוינו בשדה הזה יוקצו לקורס.

submissionModificationMode

enum (SubmissionModificationMode)

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

creatorUserId

string

מזהה של המשתמש שיצר את העבודה.

קריאה בלבד.

topicId

string

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

gradeCategory

object (GradeCategory)

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

קריאה בלבד.

previewVersion

enum (PreviewVersion)

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

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

object (Assignment)

פרטי המטלה. השדה הזה מאוכלס רק כשהערך בשדה workType הוא ASSIGNMENT.

קריאה בלבד.

multipleChoiceQuestion

object (MultipleChoiceQuestion)

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

gradingPeriodId

string

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

  • אם לא צוין מזהה של תקופה למתן ציונים, המזהה יוגדר על סמך dueDate (או על סמך scheduledTime אם לא הוגדר dueDate).
  • כדי לציין שאין שיוך לתקופה למתן ציונים, צריך להגדיר את השדה הזה למחרוזת ריקה ("").
  • אם מציינים את המזהה, הוא צריך להיות זהה למזהה של התקופה למתן ציונים שכבר קיימת בקורס.

CourseWorkState

מצבים אפשריים כמובן.

טיפוסים בני מנייה (enum)
COURSE_WORK_STATE_UNSPECIFIED לא צוינה מדינה. הערך הזה לא מוחזר אף פעם.
PUBLISHED סטטוס של עבודה שפורסמה. זהו מצב ברירת המחדל.
DRAFT סטטוס של עבודה שעדיין לא פורסמה. העבודה במצב הזה גלויה רק למורים של קורסים ולמנהלי דומיינים.
DELETED סטטוס של עבודה שפורסמה אבל נמחקה עכשיו. העבודה במצב הזה גלויה רק למורים של קורסים ולמנהלי דומיינים. העבודה במצב הזה נמחקת אחרי כמה זמן.

SubmissionModificationMode

מצבי שינוי אפשריים להגשות של תלמידים.

טיפוסים בני מנייה (enum)
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED לא צוין מצב שינוי. הערך הזה לא מוחזר אף פעם.
MODIFIABLE_UNTIL_TURNED_IN ניתן לשנות פריטים שנשלחו לפני שמגישים אותם.
MODIFIABLE ניתן לשנות את הפריטים שנשלחו בכל שלב.

מטלה

פרטים נוספים על המטלות.

ייצוג JSON
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
שדות
studentWorkFolder

object (DriveFolder)

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

MultipleChoiceQuestion

פרטים נוספים לשאלות אמריקאיות.

ייצוג JSON
{
  "choices": [
    string
  ]
}
שדות
choices[]

string

אפשרויות אפשריות.

שיטות

create

יצירת עבודה בקורס.

delete

מחיקת עבודה בקורס.

get

מחזיר את העבודה בקורס.

getAddOnContext

קבלת מטא-נתונים של תוספים ל-Classroom בהקשר של פוסט ספציפי.

list

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

modifyAssignees

שינוי מצב ההקצאה והאפשרויות של העבודה.

patch

מעדכנים שדה אחד או יותר בעבודה בקורס.