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

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

קריאה בלבד.

userId

string

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

קריאה בלבד.

creationTime

string (Timestamp format)

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

קריאה בלבד.

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

updateTime

string (Timestamp format)

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

קריאה בלבד.

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

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

אתה יכול לראות עוד פרטים בכתובת courseWork.create.

קריאה בלבד.

submissionHistory[]

object (SubmissionHistory)

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

קריאה בלבד.

previewVersion

enum (PreviewVersion)

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

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

object (AssignmentSubmission)

תוכן שנשלח כאשר הקורסWorkType הוא ASSIGNMENT.

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

shortAnswerSubmission

object (ShortAnswerSubmission)

תוכן שמוגש כאשר הקורסWorkType הוא SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

תוכן שנשלח כאשר aboutWorkType הוא 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

היסטוריית השליחה. בשלב הזה, המידע הזה כולל נתונים היסטוריים על מדינות (States) וציונים.

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

המועד שבו השתנה הציון של המטלה.

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

שיטות

get

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

list

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

modifyAttachments

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

patch

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

reclaim

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

return

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

turnIn

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