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, שבה צריך להגיש את העבודה בקורס.

אם לא צוין dueTime בעבודה עם dueDate, הערך של dueTime בעבודה יוגדר כ-23:59 בתאריך היעד.
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

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