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

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