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

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

פרטים נוספים מופיעים במאמר 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 ששימשה לאחזור המשאב הזה.
learningGoals[]

object (LearningGoal)

אופציונלי.

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

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