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)

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

קריאה בלבד.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

קריאה בלבד.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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)

פלט בלבד. גרסת ה-Preview של ה-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)

מתי הבקשה הגיעה למצב הזה.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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)

מתי הציון של ההגשה השתנה.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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

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