REST Resource: courses.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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
שדות
courseId

string

המזהה של הקורס.

לקריאה בלבד.
id

string

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

לקריאה בלבד.
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)

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

לקריאה בלבד.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

לקריאה בלבד.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
dueDate

object (Date)

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

object (TimeOfDay)

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

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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)

פלט בלבד. גרסת טרום-ההשקה (Preview) של ה-API ששימשה לאחזור המשאב הזה.
learningGoals[]

object (LearningGoal)

אופציונלי.

הפניות ליעדי למידה שמצורפים לעבודה הזו. עבודה בקורס יכולה לכלול עד 10 יעדי למידה. השדה הזה מאוכלס רק אם מוגדר previewVersion מתאים.
פרטים נוספים שספציפיים לסוג העבודה. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
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

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