- แหล่งข้อมูล: การส่งงานของนักเรียน
- RubricGrade
- AssignmentSubmission
- ไฟล์แนบ
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- สถานะ
- GradeHistory
- GradeChangeType
- เมธอด
แหล่งข้อมูล: การส่งงานของนักเรียน
การส่งงานของนักเรียนสำหรับงานในหลักสูตร
ระบบจะสร้าง StudentSubmission
รายการเมื่อมีการสร้างรายการ CourseWork
งานที่นักเรียนส่งที่ไม่เคยมีการเข้าถึง (เช่น ด้วย state
= ใหม่) อาจไม่มีเวลาที่สร้างหรือเวลาในการอัปเดต
การแสดง JSON |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
ช่อง | |
---|---|
courseId |
ตัวระบุของหลักสูตร อ่านอย่างเดียว |
courseWorkId |
ตัวระบุสำหรับงานหลักสูตรที่สอดคล้องกับตัวระบุดังกล่าว อ่านอย่างเดียว |
id |
ตัวระบุที่ Classroom กำหนดสำหรับงานที่นักเรียนส่ง ซึ่งแตกต่างจากการส่งสำหรับงานในหลักสูตรที่เกี่ยวข้อง อ่านอย่างเดียว |
userId |
ตัวระบุของนักเรียนที่เป็นเจ้าของงานที่ส่งนี้ อ่านอย่างเดียว |
creationTime |
เวลาที่สร้างข้อมูลที่ส่งนี้ ระบบอาจไม่ได้ตั้งค่านี้หากนักเรียนไม่ได้เข้าถึงรายการนี้ อ่านอย่างเดียว การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
updateTime |
เวลาอัปเดตล่าสุดของการส่งนี้ ระบบอาจไม่ได้ตั้งค่านี้หากนักเรียนไม่ได้เข้าถึงรายการนี้ อ่านอย่างเดียว การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
state |
สถานะของข้อมูลที่ส่งนี้ อ่านอย่างเดียว |
late |
การส่งครั้งนี้ล่าช้าหรือไม่ อ่านอย่างเดียว |
draftGrade |
คะแนนที่รอดำเนินการ (ไม่บังคับ) หากไม่ได้ตั้งค่า ระบบจะไม่ตั้งค่าคะแนน ค่านี้ต้องไม่เป็นจำนวนติดลบ อนุญาตให้ใช้ค่าทศนิยม (ที่ไม่ใช่จำนวนเต็ม) ได้ แต่ปัดเศษเป็นทศนิยม 2 ตำแหน่ง มีเพียงครูของหลักสูตรเท่านั้นที่จะเห็นและแก้ไขได้ |
assignedGrade |
คะแนนที่ไม่บังคับ หากไม่ได้ตั้งค่า ระบบจะไม่ตั้งค่าคะแนน ค่านี้ต้องไม่เป็นจำนวนติดลบ อนุญาตให้ใช้ค่าทศนิยม (ที่ไม่ใช่จำนวนเต็ม) ได้ แต่ปัดเศษเป็นทศนิยม 2 ตำแหน่ง เฉพาะครูของหลักสูตรเท่านั้นที่แก้ไขรายการนี้ได้ |
rubricId |
เอาต์พุตเท่านั้น ตัวระบุของเกณฑ์การให้คะแนนที่แนบอยู่กับงานในหลักสูตรนี้และใช้สำหรับให้คะแนนงานที่นักเรียนส่ง รหัสนี้ว่างเปล่าหากไม่มีเกณฑ์การให้คะแนน รหัสนี้จะแสดงเกณฑ์การให้คะแนนที่ใช้งานอยู่ในปัจจุบัน ซึ่งจะมีการเปลี่ยนแปลงหากครูลบและสร้างเกณฑ์การให้คะแนนดังกล่าวใหม่ อ่านอย่างเดียว |
draftRubricGrades |
คะแนนแบบตามเกณฑ์ที่รอดำเนินการตามเกณฑ์ของเกณฑ์การให้คะแนน แผนที่นี้จะว่างเปล่าหากไม่มีเกณฑ์การให้คะแนนแนบไปกับงานของหลักสูตรนี้ หรือหากมีการแนบเกณฑ์การให้คะแนนไว้ แต่ไม่มีการกำหนดคะแนนตามเกณฑ์ใดๆ ระบบจะป้อนข้อมูลคะแนนสำหรับคะแนนที่ตั้งค่าไว้เท่านั้น คีย์: รหัสเกณฑ์ของเกณฑ์การให้คะแนน อ่านอย่างเดียว ออบเจ็กต์ที่มีรายการคู่ |
assignedRubricGrades |
กำหนดคะแนนตามเกณฑ์ตามเกณฑ์ของเกณฑ์การให้คะแนน แผนที่นี้จะว่างเปล่าหากไม่มีเกณฑ์การให้คะแนนแนบไปกับงานของหลักสูตรนี้ หรือหากมีการแนบเกณฑ์การให้คะแนนไว้ แต่ไม่มีการกำหนดคะแนนในเกณฑ์ใดๆ ระบบจะป้อนข้อมูลคะแนนสำหรับคะแนนที่ตั้งค่าไว้เท่านั้น คีย์: รหัสเกณฑ์ของเกณฑ์การให้คะแนน อ่านอย่างเดียว ออบเจ็กต์ที่มีรายการคู่ |
alternateLink |
ลิงก์แบบเต็มไปยังงานที่ส่งใน UI ทางเว็บของ Classroom อ่านอย่างเดียว |
courseWorkType |
ประเภทของงานในหลักสูตรที่ส่งให้ อ่านอย่างเดียว |
associatedWithDeveloper |
งานที่นักเรียนส่งเชื่อมโยงกับโปรเจ็กต์แผงควบคุมสำหรับนักพัฒนาซอฟต์แวร์ที่ส่งคำขอหรือไม่ ดูรายละเอียดเพิ่มเติมได้ที่ อ่านอย่างเดียว |
submissionHistory[] |
ประวัติการส่งงาน (รวมถึงประวัติสถานะและคะแนน) อ่านอย่างเดียว |
previewVersion |
เอาต์พุตเท่านั้น เวอร์ชันตัวอย่างของ API ซึ่งต้องตั้งค่าเพื่อให้เข้าถึงความสามารถของ API ใหม่ๆ ที่พร้อมใช้งานสำหรับนักพัฒนาซอฟต์แวร์ในโปรแกรมทดลองใช้ |
ฟิลด์การรวม content เนื้อหาที่ส่ง ประเภทที่เฉพาะเจาะจงขึ้นอยู่กับค่าของ course_work_type content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
assignmentSubmission |
เนื้อหาการส่งเมื่อ programWorkType เป็น ASSIGNMENT นักเรียนจะแก้ไขเนื้อหานี้ได้โดยใช้ |
shortAnswerSubmission |
เนื้อหาการส่งเมื่อ programWorkType เป็น SHORT_ANSWER_QUESTION |
multipleChoiceSubmission |
เนื้อหาที่ส่งเมื่อ programWorkType เป็น MULTIPLE_CHOICE_QUESTION |
RubricGrade
ชุดคะแนนแบบตามเกณฑ์สำหรับงานที่นักเรียนส่ง เกณฑ์ของเกณฑ์การให้คะแนนมีรายการได้สูงสุด 1 รายการต่อเกณฑ์
การแสดง JSON |
---|
{ "criterionId": string, "levelId": string, "points": number } |
ช่อง | |
---|---|
criterionId |
ไม่บังคับ รหัสเกณฑ์ |
levelId |
ไม่บังคับ รหัสระดับของระดับที่เลือก (ไม่บังคับ) หากเว้นว่างไว้ แสดงว่าไม่ได้เลือกระดับ |
points |
ไม่บังคับ คะแนน (ไม่บังคับ) ที่กำหนดให้กับเกณฑ์นี้ มักจะอิงตามระดับ ระดับอาจมีหรือไม่มีคะแนน หากไม่ได้ตั้งค่า ระบบจะไม่กำหนดคะแนนสำหรับเกณฑ์นี้ |
AssignmentSubmission
งานของนักเรียน
การแสดง JSON |
---|
{
"attachments": [
{
object ( |
ช่อง | |
---|---|
attachments[] |
ไฟล์แนบที่นักเรียนเพิ่ม ไฟล์ในไดรฟ์ซึ่งสอดคล้องกับสื่อการเรียนการสอนของชั้นเรียนที่มีโหมดการแชร์ STUDENT_COPY อาจยังไม่มีอยู่ หากนักเรียนยังไม่ได้เข้าถึงงานใน Classroom ระบบจะเติมข้อมูลเมตาไฟล์แนบบางรายการในกรณีที่ผู้ใช้ที่ส่งคำขอมีสิทธิ์เข้าถึงเท่านั้น ฟิลด์ตัวระบุและ alternateLink จะสามารถใช้ได้ตลอดเวลา แต่อาจยังไม่มีฟิลด์อื่นๆ (เช่น ชื่อ) |
ความใกล้ชิด
เพิ่มไฟล์แนบในงานของนักเรียนแล้ว
เมื่อสร้างไฟล์แนบ ระบบจะไม่รองรับการตั้งค่าช่อง form
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์การรวม attachment ข้อมูลไฟล์แนบ attachment ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
driveFile |
ไฟล์แนบ Google ไดรฟ์ |
youTubeVideo |
ไฟล์แนบวิดีโอ YouTube |
link |
ไฟล์แนบลิงก์ |
form |
ไฟล์แนบ Google ฟอร์ม |
ShortAnswerSubmission
งานของนักเรียนสำหรับคำถามที่ต้องการคำตอบสั้นๆ
การแสดง JSON |
---|
{ "answer": string } |
ช่อง | |
---|---|
answer |
คำตอบของนักเรียนสำหรับคำถามที่ต้องการคำตอบสั้นๆ |
MultipleChoiceSubmission
งานของนักเรียนสำหรับคำถามแบบหลายตัวเลือก
การแสดง JSON |
---|
{ "answer": string } |
ช่อง | |
---|---|
answer |
ตัวเลือกที่นักเรียนเลือกได้ |
SubmissionHistory
ประวัติการส่งแอป ซึ่งในปัจจุบันจะรวมประวัติสถานะและเกรดไว้ด้วย
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์การรวม type ประเภทของ SubmissionHistory อาจเป็น StateHistory, GradeHistory type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
stateHistory |
ข้อมูลประวัติสถานะของงานที่ส่ง (หากมี) |
gradeHistory |
ข้อมูลประวัติการให้คะแนนงานที่ส่ง (หากมี) |
StateHistory
ประวัติของแต่ละสถานะการส่งนี้
การแสดง JSON |
---|
{
"state": enum ( |
ช่อง | |
---|---|
state |
ขั้นตอนของไปป์ไลน์เวิร์กโฟลว์ |
stateTimestamp |
เมื่อการส่งเข้าสู่สถานะนี้ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
actorUserId |
ครูหรือนักเรียนที่ทำการเปลี่ยนแปลง |
รัฐ
รัฐที่เป็นไปได้สำหรับการส่งคำขอ
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 ( |
ช่อง | |
---|---|
pointsEarned |
เศษของคะแนนในขณะนี้ในประวัติคะแนนที่ส่ง |
maxPoints |
ตัวส่วนของคะแนนในขณะนี้ในประวัติคะแนนที่ส่ง |
gradeTimestamp |
เมื่อมีการเปลี่ยนคะแนนงาน การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
actorUserId |
ครูที่เปลี่ยนคะแนน |
gradeChangeType |
ประเภทของการเปลี่ยนแปลงคะแนนในขณะนี้ในประวัติคะแนนที่ส่ง |
GradeChangeType
ประเภทการเปลี่ยนแปลงคะแนนที่เป็นไปได้
Enum | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
ไม่ได้ระบุประเภทการเปลี่ยนแปลงคะแนน ไม่ควรส่งกลับ |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
การเปลี่ยนแปลงตัวเลขเศษของคะแนนคร่าวๆ |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
การเปลี่ยนแปลงตัวเศษของคะแนนที่มอบหมาย |
MAX_POINTS_CHANGE |
การเปลี่ยนแปลงตัวส่วนของเกรด |
วิธีการ |
|
---|---|
|
ส่งคืนงานที่นักเรียนส่ง |
|
แสดงผลรายการงานที่นักเรียนส่งซึ่งผู้ขอได้รับอนุญาตให้ดู โดยพิจารณาขอบเขต OAuth ของคำขอ |
|
แก้ไขไฟล์แนบในงานที่นักเรียนส่ง |
|
อัปเดตช่องที่นักเรียนส่งอย่างน้อย 1 ช่อง |
|
อ้างสิทธิ์งานที่นักเรียนส่งในนามของนักเรียนที่เป็นเจ้าของผลงานนั้นอีกครั้ง |
|
ส่งคืนงานที่นักเรียนส่ง |
|
ส่งงานของนักเรียน |