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

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

קריאה בלבד.
title

string

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

string

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

object (Material)

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

אפשר להוסיף לעבודת סטודנט עד 20 פריטים של חומרים.
state

enum (CourseWorkState)

הסטטוס של מטלת הקורס הזו. אם לא צוין מצב, מצב ברירת המחדל הוא DRAFT.
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".
dueDate

object (Date)

תאריך אופציונלי, לפי שעון UTC, שבו יש להגיש את המטלה. צריך לציין את הערך הזה אם צוין dueTime.
dueTime

object (TimeOfDay)

השעה ביום, לפי שעון UTC, שבה המטלה צריכה להימסר. צריך לציין את הערך הזה אם צוין dueDate.
scheduledTime

string (Timestamp format)

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

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

number

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

enum (CourseWorkType)

סוג העבודה.

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

boolean

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

פרטים נוספים זמינים בכתובת 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

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

Methods

create

 יצירת מטלות.

delete

 מחיקה של מטלה.

get

 החזרת עבודות.

getAddOnContext

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

list

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

modifyAssignees

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

patch

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