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)
  },

  // 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.
}
שדות
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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

קריאה בלבד.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
maxPoints

number

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

enum (CourseWorkType)

סוג העבודה בקורס.

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

boolean

האם פריט העבודה הזה בקורס משויך לפרויקט ב-Play 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)

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

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

object (Assignment)

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

קריאה בלבד.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

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

CourseWorkState

מצבים אפשריים של העבודה.

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

SubmissionModificationMode

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

טיפוסים בני מנייה (enums)
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

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