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),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
שדות
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

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

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

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

object (SubmissionHistory)

היסטוריית השליחה (כולל היסטוריית המצב והציון).

קריאה בלבד.
previewVersion

enum (PreviewVersion)

פלט בלבד. גרסת הטרום-השקה של ה-API. ההגדרה הזו נדרשת כדי לגשת ליכולות חדשות של API שזמינות למפתחים בתוכנית ה-Preview.
שדה איחוד content. תוכן השליחה. הסוג הספציפי תלוי בערך של course_work_type. הערך content יכול להיות רק אחד מהבאים:
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 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
שדות
שדה איחוד attachment. נתוני הקובץ המצורף. הערך attachment יכול להיות רק אחד מהבאים:
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 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
שדות
שדה איחוד type. סוג ה-SubmissionHistory, יכול להיות StateHistory או GradeHistory. הערך type יכול להיות רק אחד מהבאים:
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

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

מדינה

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

טיפוסים בני מנייה (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

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