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 "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

เวลาที่อัปเดตล่าสุดของการส่งนี้ ระบบอาจยกเลิกการตั้งค่านี้หากนักเรียนไม่ได้เข้าถึงรายการนี้

อ่านอย่างเดียว

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

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 ที่มีให้กับนักพัฒนาซอฟต์แวร์ในโปรแกรมทดลองใช้

ช่องการรวม 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

ชุดคะแนนแบบตามเกณฑ์สำหรับงานที่นักเรียนส่ง เกณฑ์เกณฑ์การให้คะแนน 1 รายการจะมีรายการได้สูงสุด 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

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

ไฟล์แนบ

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

ไม่รองรับการตั้งค่าช่อง 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 ไดรฟ์

youTubeVideo

object (YouTubeVideo)

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

form

object (Form)

ไฟล์แนบ Google ฟอร์ม

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 ประเภทของข้อมูลที่ส่ง โดยอาจเป็น 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)

เมื่อการส่งเข้าสู่สถานะนี้

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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

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

reclaim

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

return

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

turnIn

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