Method: courses.courseWork.studentSubmissions.reclaim

Thay mặt học viên sở hữu bài nộp, lấy lại bài nộp của học viên.

Khi bạn thu hồi bài nộp của học viên, quyền sở hữu các tệp đính kèm trên Drive sẽ được chuyển cho học viên và trạng thái bài nộp sẽ được cập nhật.

Chỉ học viên sở hữu bài nộp được yêu cầu mới có thể gọi phương thức này và chỉ dành cho bài nộp đã được nộp.

Yêu cầu này phải được thực hiện bằng dự án Developer Console của mã ứng dụng khách OAuth dùng để tạo mục bài tập tương ứng.

Phương thức này trả về các mã lỗi sau:

  • PERMISSION_DENIED nếu người dùng yêu cầu không được phép truy cập vào khoá học hoặc bài tập được yêu cầu, huỷ gửi bài tập được yêu cầu của học viên hoặc do lỗi truy cập.
  • FAILED_PRECONDITION nếu bài nộp của học viên chưa được gửi.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.
  • NOT_FOUND nếu không có khoá học, bài tập trong khoá học hoặc bài nộp của học viên được yêu cầu.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
courseId

string

Giá trị nhận dạng của khoá học. Giá trị nhận dạng này có thể là giá trị nhận dạng do Lớp học chỉ định hoặc alias.

courseWorkId

string

Giá trị nhận dạng của bài tập trong khoá học.

id

string

Giá trị nhận dạng của bài tập mà học viên đã nộp.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ trống.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.