Method: courses.courseWork.studentSubmissions.modifyAttachments

Sửa đổi các tệp đính kèm mà học viên đã nộp.

Bạn chỉ có thể thêm tệp đính kèm vào bài làm mà học viên đã nộp thuộc về đối tượng của bài tập trong khoá học có workType là ASSIGNMENT.

Yêu cầu này phải do dự án Developer Console của mã ứng dụng OAuth (dùng để tạo mục bài tập trong khoá học tương ứng) đưa ra yêu cầu này.

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 trong khoá học mà họ yêu cầu, nếu người dùng không được phép sửa đổi các tệp đính kèm trên bài tập mà học viên đã gửi hoặc vì lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.
  • NOT_FOUND nếu khoá học, bài tập khoá học hoặc nội dung học viên gửi không tồn tại.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Các 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

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "addAttachments": [
    {
      object (Attachment)
    }
  ],
  "previewVersion": enum (PreviewVersion)
}
Các trường
addAttachments[]

object (Attachment)

Tệp đính kèm để thêm. Một bài tập học viên nộp không được có quá 20 tệp đính kèm.

Không hỗ trợ Form tệp đính kèm.
previewVersion

enum (PreviewVersion)

Không bắt buộc. Phiên bản xem trước của API. Bạn phải đặt khoá này để có thể sử dụng các tính năng API mới dành cho nhà phát triển trong Chương trình dùng thử.

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 phiên bản 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.