Method: courses.courseWork.studentSubmissions.patch

Cập nhật một hoặc nhiều trường của bài tập mà học viên đã nộp.

Hãy xem google.classroom.v1.StudentSubmission để biết thông tin chi tiết về những trường có thể được cập nhật và người có thể thay đổi các trường đó.

Yêu cầu này phải được thực hiện bởi dự án Developer Console của mã ứng dụng OAuth dùng để tạo mục bài tập trên lớp tương ứng hoặc tệp đính kèm tiện ích bổ sung có bật tính năng Đồng bộ hoá điểm trên mục bài tập trên lớp tương ứng.

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

  • PERMISSION_DENIED nếu dự án của nhà phát triển yêu cầu không tạo bài tập trên lớp tương ứng hoặc tệp đính kèm tiện ích bổ sung trên bài tập trên lớp tương ứng khi bật tính năng Đồng bộ hoá điểm, nếu người dùng không được phép thực hiện nội dung sửa đổi được yêu cầu đối với bài tập đã nộp của học viên hoặc đối với lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu có định dạng không chính xác.
  • NOT_FOUND nếu khoá học, bài tập hoặc bài tập đã nộp của học viên được yêu cầu không tồn tại.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông 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 một alias.
courseWorkId

string

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

string

Mã nhận dạng của bài tập đã nộp của học viên.

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Mặt nạ xác định những trường cần cập nhật trong bài tập đã gửi của học viên. Bạn phải điền thông tin vào trường này để cập nhật. Quá trình cập nhật sẽ thất bại nếu bạn chỉ định các trường không hợp lệ.

Giáo viên có thể chỉ định các trường sau:

  • draftGrade
  • assignedGrade

Đây là danh sách tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
previewVersion

enum (PreviewVersion)

Không bắt buộc. Phiên bản xem trước của API. Bạn phải đặt giá trị này để truy cập vào các chức năng API mới được cung cấp cho nhà phát triển trong Chương trình dùng trước.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của StudentSubmission.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của StudentSubmission.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/classroom.coursework.students
  • 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.