Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

Cập nhật dữ liệu liên quan đến việc gửi tệp đính kèm có tiện ích bổ sung.

Tiện ích bổ sung phải là tác giả ban đầu của tệp đính kèm và tệp đính kèm phải có bộ giá trị maxPoints dương.

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

  • PERMISSION_DENIED để biết lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.
  • NOT_FOUND nếu một trong các tài nguyên đã xác định không tồn tại.

Yêu cầu HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

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

Tham số đường dẫn

Thông số
courseId

string

Bắt buộc. Giá trị nhận dạng của khoá học.
itemId

string

Giá trị nhận dạng của Announcement, CourseWork hoặc CourseWorkMaterial mà tệp đính kèm sẽ được đính kèm. Trường này là bắt buộc, nhưng không được đánh dấu như vậy trong khi chúng ta di chuyển từ postId.
attachmentId

string

Bắt buộc. Giá trị nhận dạng của tệp đính kèm.
submissionId

string

Bắt buộc. Mã nhận dạng bài tập mà học viên đã nộp.

Tham số truy vấn

Thông số
postId
(deprecated)

string

Không bắt buộc. Không dùng nữa, chuyển sang dùng itemId.
updateMask

string (FieldMask format)

Bắt buộc. Mặt nạ xác định những trường trên tệp đính kèm cần cập nhật. Không cập nhật được nếu bạn chỉ định các trường không hợp lệ. Nếu một trường hỗ trợ các giá trị trống, thì bạn có thể xoá trường đó bằng cách chỉ định trường đó trong mặt nạ cập nhật chứ không phải trong đối tượng AddOnAttachmentStudentSubmission.

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

  • pointsEarned

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

Nội dung yêu cầu

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

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 AddOnAttachmentStudentSubmission.

Phạm vi uỷ quyền

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

  • https://www.googleapis.com/auth/classroom.addons.teacher

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