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)

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

עבודות יכולות לכלול עד 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

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

פרטים נוספים מופיעים במאמר 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

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