REST Resource: courses.courseWork.studentSubmissions

משאב: מטלות לתלמידים

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

StudentSubmission פריטים נוצרים בעת יצירת פריט CourseWork.

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

ייצוג 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)

מועד היצירה של הקובץ המצורף. אם התלמיד/ה לא ניגש/ה לפריט הזה, אפשר לבטל את ההגדרה שלו.

קריאה בלבד.

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

string (Timestamp format)

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

קריאה בלבד.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

האם ההגשה הזו של התלמיד משויכת לפרויקט ב-Play Console שהגיש את הבקשה.

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

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

object (SubmissionHistory)

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

קריאה בלבד.
previewVersion

enum (PreviewVersion)

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

object (AssignmentSubmission)

שליחת תוכן כש-courseWorkType הוא בוחן.

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

object (ShortAnswerSubmission)

תוכן שליחת התוכן כאשר classWorkType הוא SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

שליחת התוכן כאשר הערך של classWorkType הוא 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)

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

חלק מהמטא-נתונים של הקבצים המצורפים מאוכלסים רק אם למשתמש ששלח את הבקשה יש הרשאה לגשת אליהם. השדות 'מזהה' ו'קישור חלופי' תמיד זמינים, אבל אחרים (למשל 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. סוג היסטוריית ההגשות, יכול להיות אחד מהיסטוריית המדינה, היסטוריית הציונים. הערך של type יכול להיות רק אחת מהאפשרויות הבאות:
stateHistory

object (StateHistory)

פרטי היסטוריית המדינה של הבקשה, אם קיימים.
gradeHistory

object (GradeHistory)

פרטי היסטוריית הציונים של ההגשה, אם יש כאלה.

StateHistory

ההיסטוריה של כל מדינה שבה נשלח התוכן הזה.

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

enum (State)

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

string (Timestamp format)

מתי השליחה עברה למצב הזה.

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

string

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

ארץ

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

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

תאריך השינוי של ציון ההגשה.

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

string

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

enum (GradeChangeType)

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

GradeChangeType

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

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

שיטות

get

 מחזירה הגשה של תלמיד.

list

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

modifyAttachments

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

patch

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

reclaim

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

return

 מחזירה הגשה של תלמיד.

turnIn

 מגיש את הקובץ של התלמיד או התלמידה.