Method: courses.courseWork.studentSubmissions.return

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

การส่งคืนงานที่นักเรียนส่งจะโอนสิทธิ์การเป็นเจ้าของไฟล์ในไดรฟ์ที่แนบมาให้กับนักเรียน และอาจอัปเดตสถานะการส่งด้วย ซึ่งแตกต่างจากแอปพลิเคชัน Classroom เนื่องจากการส่งคืนงานที่นักเรียนส่งมาจะไม่ตั้งค่า assignedGrade เป็นค่า draftGrade

มีเพียงครูของหลักสูตรที่มีงานที่นักเรียนส่งมาตามคำขอเท่านั้นที่เรียกใช้เมธอดนี้ได้

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

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

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

คำขอ HTTP

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

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

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

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

string

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

courseWorkId

string

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

id

string

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

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะเป็นออบเจ็กต์ JSON ว่าง

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

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