REST Resource: courses.courseWork.studentSubmissions

משאב: StudentSubmission

עבודה שהתלמיד הגיש בקורס.

פריטים מסוג StudentSubmission נוצרים כשיוצרים פריט מסוג CourseWork.

יכול להיות שלמטלות שהתלמידים הגישו ועדיין לא נפתחו (כלומר, עם state = NEW) לא יהיה זמן יצירה או זמן עדכון.

ייצוג ב-JSON 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
שדות
courseId

string

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

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

string

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

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

string

מזהה שהוקצה ב-Classroom לעבודה שהתלמיד/ה הגישו. המזהה הזה ייחודי לכל הגשה של עבודה בקורס הרלוונטי.

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

string

המזהה של התלמיד/ה שהגישו את העבודה הזו.

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

enum (SubmissionState)

מצב ההגשה.

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

boolean

אם העבודה הוגשה באיחור.

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

number

ציון בהמתנה (אופציונלי). אם לא מוגדר, לא הוגדר ציון. הערך לא יכול להיות שלילי. אפשר להשתמש בערכים עשרוניים (כלומר, לא מספרים שלמים), אבל הם מעוגלים לשתי ספרות אחרי הנקודה העשרונית.

רק מורים בקורס יכולים לראות ולשנות את זה.
assignedGrade

number

ציון אופציונלי. אם לא מוגדר, לא הוגדר ציון. הערך לא יכול להיות שלילי. אפשר להשתמש בערכים עשרוניים (כלומר, לא מספרים שלמים), אבל הם מעוגלים לשתי ספרות אחרי הנקודה העשרונית.

רק מורים בקורס יכולים לשנות את ההגדרה הזו.
rubricId

string

פלט בלבד. המזהה של קריטריון ההערכה שמצורף כרגע לעבודה בקורס ומשמש למתן ציון להגשה הזו של התלמיד/ה.

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

לקריאה בלבד.

draftRubricGrades

map (key: string, value: object (RubricGrade))

ציונים בהמתנה לפי קריטריוני ההערכה.

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

לקריאה בלבד.

אובייקט שמכיל רשימה של צמדי "key": value. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

map (key: string, value: object (RubricGrade))

ציונים שהוקצו לקריטריונים של סולם הערכה.

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

לקריאה בלבד.

אובייקט שמכיל רשימה של צמדי "key": value. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

סוג העבודה שהמטלה הזו מיועדת לה.

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

boolean

אם העבודה הזו של התלמיד/ה משויכת לפרויקט ב-Developer Console ששולח את הבקשה.

פרטים נוספים מופיעים בכתובת courseWork.create.

לקריאה בלבד.
submissionHistory[]

object (SubmissionHistory)

ההיסטוריה של ההגשה (כולל היסטוריית המצבים והציונים).

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

enum (PreviewVersion)

פלט בלבד. גרסת טרום-השקה (Preview) של ה-API. צריך להגדיר את זה כדי לגשת ליכולות החדשות של ה-API שזמינות למפתחים בתוכנית Preview.
תוכן הבקשה. הסוג הספציפי תלוי בערך של course_work_type. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
assignmentSubmission

object (AssignmentSubmission)

תוכן ההגשה כש-courseWorkType הוא ASSIGNMENT.

התלמידים יכולים לשנות את התוכן הזה באמצעות studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

תוכן ההגשה כש-courseWorkType הוא SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

תוכן ההגשה כש-courseWorkType הוא MULTIPLE_CHOICE_QUESTION.
סוף השדות שמוציאים זה את זה.

RubricGrade

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

ייצוג ב-JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
שדות
criterionId

string

אופציונלי. מזהה הקריטריון.
levelId

string

אופציונלי. מזהה הרמה האופציונלי של הרמה שנבחרה. אם השדה ריק, לא נבחרה רמה.
points

number

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

AssignmentSubmission

עבודה של תלמיד או תלמידה במטלה.

ייצוג ב-JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
שדות
attachments[]

object (Attachment)

קבצים מצורפים שהתלמיד או התלמידה הוסיפו. יכול להיות שקבצים ב-Drive שתואמים לחומרי לימוד עם מצב שיתוף STUDENT_COPY עדיין לא קיימים אם התלמיד לא ניגש למטלה ב-Classroom.

חלק מהמטא-נתונים של הקבצים המצורפים מאוכלסים רק אם למשתמש ששלח את הבקשה יש הרשאת גישה אליהם. השדות Identifier ו-alternateLink תמיד זמינים, אבל יכול להיות ששדות אחרים (למשל, title) לא יהיו זמינים.

קובץ מצורף

קובץ מצורף נוסף לעבודה שהוקצתה לתלמיד/ה.

כשיוצרים קבצים מצורפים, אי אפשר להגדיר את השדה form.

ייצוג ב-JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
שדות
נתוני הקובץ המצורף. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
driveFile

object (DriveFile)

קובץ מצורף מ-Google Drive.
youTubeVideo

object (YouTubeVideo)

סרטון ב-YouTube מצורף.
form

object (Form)

קובץ מצורף מ-Google Forms.
סוף השדות שמוציאים זה את זה.

ShortAnswerSubmission

עבודת תלמיד/ה לשאלה שיש להשיב עליה בתשובה קצרה.

ייצוג ב-JSON 
{
  "answer": string
}
שדות
answer

string

תשובה של תלמיד לשאלה שיש להשיב עליה בתשובה קצרה.

MultipleChoiceSubmission

עבודת תלמיד בשאלה אמריקאית.

ייצוג ב-JSON 
{
  "answer": string
}
שדות
answer

string

התלמיד או התלמידה בוחרים את האפשרות.

SubmissionHistory

היסטוריית השליחה. נכון לעכשיו, זה כולל את היסטוריית המצבים והציונים.

ייצוג ב-JSON 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
שדות
סוג של SubmissionHistory, יכול להיות אחד מהערכים StateHistory, ‏ GradeHistory. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
stateHistory

object (StateHistory)

היסטוריית המצבים של ההגשה, אם יש כזו.
gradeHistory

object (GradeHistory)

היסטוריית הציונים של ההגשה, אם יש כזו.
סוף השדות שמוציאים זה את זה.

StateHistory

ההיסטוריה של כל סטטוס שהבקשה הזו הייתה בו.

ייצוג ב-JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
שדות
state

enum (State)

השלב בתהליך העבודה.
stateTimestamp

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".
actorUserId

string

המורה או התלמיד/ה שביצעו את השינוי.

מדינה (State)

המצבים האפשריים של הגשה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED לא צוינה מדינה. הערך הזה לא אמור להיות מוחזר.
CREATED הבקשה נוצרה.
TURNED_IN התלמיד או התלמידה הגישו מסמך שהוקצה להם, שיכול להיות תבנית.
RETURNED המורה החזיר/ה את המסמך שהוקצה לתלמיד/ה.
RECLAIMED_BY_STUDENT התלמיד/ה הגיש/ה את המסמך שהוקצה, ואז בחר/ה באפשרות "ביטול ההגשה" של המטלה, מה שנתן לו/ה שוב שליטה כבעלים.
STUDENT_EDITED_AFTER_TURN_IN התלמיד או התלמידה ערכו את המטלה אחרי שהגישו אותה. נכון לעכשיו, השדה הזה משמש רק לשאלות, כשהתלמיד עורך את התשובה שלו.

GradeHistory

ההיסטוריה של כל ציון במטלה הזו.

ייצוג ב-JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
שדות
pointsEarned

number

המונה של הציון בנקודת הזמן הזו בהיסטוריית הציונים של ההגשה.
maxPoints

number

המכנה של הציון בשלב הזה בהיסטוריית הציונים של ההגשה.
gradeTimestamp

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".
actorUserId

string

המורה ששינה את הציון.
gradeChangeType

enum (GradeChangeType)

סוג השינוי בציון בשלב הזה בהיסטוריית הציונים של המטלה שהוגשה.

GradeChangeType

סוגים אפשריים של שינויים בציון.

טיפוסים בני מנייה (enum)
UNKNOWN_GRADE_CHANGE_TYPE לא צוין סוג השינוי בציון. הערך הזה לא אמור להיות מוחזר.
DRAFT_GRADE_POINTS_EARNED_CHANGE שינוי במונה של ציון הטיוטה.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE שינוי במונה של הציון שהוקצה.
MAX_POINTS_CHANGE שינוי במכנה של הציון.

Methods

get

 החזרת עבודה שהוגשה על ידי תלמיד/ה.

list

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

modifyAttachments

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

patch

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

reclaim

 החזרת מטלה שהוגשה בשם התלמיד/ה שהמטלה בבעלותו/ה.

return

 החזרת עבודה שהוגשה על ידי תלמיד/ה.

turnIn

 הגשת מטלה של תלמיד/ה.