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

คะแนนที่รอดำเนินการ (ไม่บังคับ) หากไม่ได้ตั้งค่า แสดงว่าไม่มีการตั้งค่าเกรด ค่านี้ต้องไม่เป็นจำนวนติดลบ อนุญาตให้ใช้ค่าทศนิยม (ซึ่งไม่ใช่จำนวนเต็ม) แต่จะปัดเศษเป็นทศนิยม 2 ตำแหน่ง

มีเพียงครูผู้สอนเท่านั้นที่เห็นและแก้ไขข้อมูลนี้ได้
assignedGrade

number

คะแนนที่ไม่บังคับ หากไม่ได้ตั้งค่า แสดงว่าไม่มีการตั้งค่าเกรด ค่านี้ต้องไม่เป็นจำนวนติดลบ อนุญาตให้ใช้ค่าทศนิยม (นั่นคือ ไม่ใช่จำนวนเต็ม) แต่จะปัดเศษเป็นทศนิยม 2 ตำแหน่ง

มีเพียงครูผู้สอนเท่านั้นที่แก้ไขข้อมูลนี้ได้
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 ที่พร้อมให้บริการแก่นักพัฒนาซอฟต์แวร์ในโปรแกรมเวอร์ชันตัวอย่าง
เนื้อหาที่ส่ง ประเภทที่เฉพาะเจาะจงจะขึ้นอยู่กับค่าของ course_work_type ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
assignmentSubmission

object (AssignmentSubmission)

เนื้อหาของงานที่ส่งเมื่อ courseWorkType เป็น ASSIGNMENT

นักเรียนสามารถแก้ไขเนื้อหานี้ได้โดยใช้ studentSubmissions.modifyAttachments
shortAnswerSubmission

object (ShortAnswerSubmission)

เนื้อหาของงานที่ส่งเมื่อ courseWorkType เป็น SHORT_ANSWER_QUESTION
multipleChoiceSubmission

object (MultipleChoiceSubmission)

เนื้อหาของงานที่ส่งเมื่อ courseWorkType เป็น MULTIPLE_CHOICE_QUESTION
สิ้นสุดฟิลด์ที่แยกกัน

RubricGrade

คะแนนตามเกณฑ์การให้คะแนนที่กำหนดไว้สำหรับงานที่นักเรียนส่ง มีรายการได้สูงสุด 1 รายการต่อเกณฑ์การให้คะแนน

การแสดง JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
ฟิลด์
criterionId

string

ไม่บังคับ รหัสเกณฑ์
levelId

string

ไม่บังคับ รหัสระดับที่ไม่บังคับของระดับที่เลือก หากว่างเปล่า แสดงว่าไม่ได้เลือกระดับใดเลย
points

number

ไม่บังคับ คะแนนที่ไม่บังคับซึ่งกำหนดไว้สำหรับเกณฑ์นี้ โดยปกติจะอิงตามระดับ ระดับอาจมีหรือไม่มีคะแนนก็ได้ หากไม่ได้ตั้งค่า แสดงว่าไม่ได้กำหนดคะแนนสำหรับเกณฑ์นี้

AssignmentSubmission

งานของนักเรียนสำหรับงานที่มอบหมาย

การแสดง JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
ช่อง
attachments[]

object (Attachment)

ไฟล์แนบที่นักเรียนเพิ่ม ไฟล์ในไดรฟ์ที่สอดคล้องกับสื่อการเรียนการสอนที่มีโหมดการแชร์เป็น STUDENT_COPY อาจยังไม่มีอยู่หากนักเรียน/นักศึกษายังไม่ได้เข้าถึงงานใน Classroom

ระบบจะป้อนข้อมูลเมตาของไฟล์แนบบางรายการก็ต่อเมื่อผู้ใช้ที่ส่งคำขอมีสิทธิ์เข้าถึงข้อมูลเมตาดังกล่าว ช่อง Identifier และ alternateLink จะพร้อมใช้งานเสมอ แต่ช่องอื่นๆ (เช่น title) อาจไม่พร้อมใช้งาน

ไฟล์แนบ

เพิ่มไฟล์แนบลงในงานที่มอบหมายของนักเรียนแล้ว

เมื่อสร้างไฟล์แนบ ระบบจะไม่รองรับการตั้งค่าช่อง form

การแสดง JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
ช่อง
ข้อมูลไฟล์แนบ ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
driveFile

object (DriveFile)

ไฟล์แนบ Google ไดรฟ์
youTubeVideo

object (YouTubeVideo)

ไฟล์แนบวิดีโอ YouTube
form

object (Form)

ไฟล์แนบ Google ฟอร์ม
สิ้นสุดฟิลด์ที่แยกกัน

ShortAnswerSubmission

งานของนักเรียนสำหรับคำถามที่ต้องการคำตอบสั้นๆ

การแสดง JSON 
{
  "answer": string
}
ช่อง
answer

string

คำตอบของนักเรียนสำหรับคำถามที่ต้องการคำตอบสั้นๆ

MultipleChoiceSubmission

งานของนักเรียนสำหรับคำถามแบบหลายตัวเลือก

การแสดง JSON 
{
  "answer": string
}
ช่อง
answer

string

ตัวเลือกที่นักเรียนเลือก

SubmissionHistory

ประวัติการส่ง ซึ่งปัจจุบันรวมถึงประวัติสถานะและคะแนน

การแสดง JSON 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
ช่อง
ประเภทของ SubmissionHistory อาจเป็น StateHistory หรือ GradeHistory อย่างใดอย่างหนึ่ง ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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 การเปลี่ยนแปลงตัวส่วนของคะแนน

เมธอด

get

 แสดงผลงานที่นักเรียนส่ง

list

 แสดงรายการงานที่นักเรียนส่งซึ่งผู้ขอได้รับอนุญาตให้ดู โดยพิจารณาจากขอบเขต OAuth ของคำขอ

modifyAttachments

 แก้ไขไฟล์แนบของงานที่นักเรียนส่ง

patch

 อัปเดตช่องอย่างน้อย 1 ช่องของงานที่นักเรียนส่ง

reclaim

 อ้างสิทธิ์งานที่นักเรียนส่งในนามของนักเรียนที่เป็นเจ้าของงาน

return

 ส่งคืนงานของนักเรียน

turnIn

 ส่งงานของนักเรียน/นักศึกษา