Method: courses.courseWork.studentSubmissions.patch

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

ดูรายละเอียดเกี่ยวกับช่องที่อาจอัปเดตได้และผู้ที่ทำการเปลี่ยนแปลงได้ใน google.classroom.v1.StudentSubmission

คำขอนี้ต้องดำเนินการโดยโปรเจ็กต์ Developer Console ของรหัสไคลเอ็นต์ OAuth ที่ใช้สร้างรายการงานในหลักสูตรที่เกี่ยวข้อง

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • PERMISSION_DENIED หากโปรเจ็กต์นักพัฒนาซอฟต์แวร์ที่ส่งคำขอไม่ได้สร้างงานที่เกี่ยวข้องในหลักสูตร หากผู้ใช้ไม่ได้รับอนุญาตให้แก้ไขงานที่นักเรียนส่งตามที่ขอ หรือในกรณีที่มีข้อผิดพลาดในการเข้าถึง
  • INVALID_ARGUMENT หากคำขอมีรูปแบบไม่ถูกต้อง
  • NOT_FOUND หากไม่มีหลักสูตร งานในหลักสูตร หรืองานที่นักเรียนส่งเข้ามา

คำขอ HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
courseId

string

ตัวระบุของหลักสูตร ตัวระบุนี้อาจเป็นตัวระบุที่ Classroom กำหนดหรือ alias ก็ได้
courseWorkId

string

ตัวระบุงานของหลักสูตร
id

string

ตัวระบุงานที่นักเรียนส่ง

พารามิเตอร์การค้นหา

พารามิเตอร์
updateMask

string (FieldMask format)

มาสก์ที่ระบุว่าจะอัปเดตช่องใดในงานที่นักเรียนส่ง ต้องกรอกช่องนี้เพื่ออัปเดต การอัปเดตจะไม่สำเร็จหากระบุช่องไม่ถูกต้อง

ครูสามารถระบุช่องต่อไปนี้

  • draftGrade
  • assignedGrade

ซึ่งเป็นรายการชื่อฟิลด์ที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
previewVersion

enum (PreviewVersion)

ไม่บังคับ เวอร์ชันตัวอย่างของ API ซึ่งต้องตั้งค่าเพื่อให้เข้าถึงความสามารถของ API ใหม่ๆ ที่พร้อมใช้งานสำหรับนักพัฒนาซอฟต์แวร์ในโปรแกรมทดลองใช้

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ StudentSubmission

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ StudentSubmission

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์