Method: courses.courseWork.patch

Cập nhật một hoặc nhiều trường của bài tập trong khoá học.

Hãy xem google.classroom.v1.CourseWork để 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.

Yêu cầu này phải do dự án Bảng điều khiển dành cho nhà phát triển của Mã ứng dụng khách OAuth dùng để tạo mục công việc tương ứng trong khoá học.

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

  • PERMISSION_DENIED nếu dự án mà nhà phát triển đưa ra yêu cầu không tạo ra bài tập khoá học tương ứng, nếu người dùng không được phép sửa đổi theo yêu cầu đối với bài tập học viên nộp hoặc gặp lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.
  • FAILED_PRECONDITION nếu bài tập khoá học bạn yêu cầu đã bị xoá.
  • NOT_FOUND nếu khoá học hoặc bài tập trong khoá học đượ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/{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 alias.

id

string

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

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 khoá học. Đây là trường bắt buộc để 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 CourseWork. Nếu một trường không hỗ trợ các giá trị trống được đưa vào mặt nạ cập nhật và không được đặt trong đối tượng CourseWork, thì lỗi INVALID_ARGUMENT sẽ được trả về.

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

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId Có trong phiên bản V1_20240401_PREVIEW trở lên.

Đâ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"

previewVersion

enum (PreviewVersion)

Không bắt buộc. Phiên bản xem trước của API. Bạn phải đặt thuộc tính 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 thử.

Nội dung yêu cầu

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

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

Phạm vi uỷ quyền

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

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

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