Method: courses.courseWork.rubrics.patch

Cập nhật một tiêu chí chấm điểm.

Hãy xem google.classroom.v1.Rubric để biết thông tin chi tiết về những trường có thể cập nhật. Khả năng cập nhật tiêu chí chấm điểm sẽ bị giới hạn sau khi quá trình chấm điểm bắt đầu.

Yêu cầu này phải do bảng điều khiển Google Cloud của mã ứng dụng khách OAuth dùng để tạo mục bài tập của khoá học chính đưa ra.

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

  • PERMISSION_DENIED nếu dự án nhà phát triển yêu cầu không tạo bài tập tương ứng trong khoá học, nếu người dùng không được phép sửa đổi theo yêu cầu đối với tiêu chí chấm điểm hoặc do có lỗi truy cập. Mã lỗi này cũng được trả về nếu quá trình chấm điểm đã bắt đầu trên tiêu chí chấm điểm.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng và đối với lỗi yêu cầu sau:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND nếu khoá học, bài tập trong khoá học hoặc tiêu chí chấm điểm được yêu cầu không tồn tại, hoặc nếu người dùng không có quyền truy cập vào bài tập tương ứng trong khoá học.
  • INTERNAL nếu chấm điểm đã bắt đầu trên tiêu chí chấm điểm.

Yêu cầu HTTP

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

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

string

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

string

Không bắt buộc. Giá trị nhận dạng của tiêu chí chấm điểm.

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Không bắt buộc. Mặt nạ giúp xác định các trường cần cập nhật theo tiêu chí chấm điểm. Đây là trường bắt buộc để cập nhật. Quá trình cập nhật sẽ không thành công nếu bạn chỉ định các trường không hợp lệ. Có nhiều tuỳ chọn để xác định tiêu chí của một tiêu chí chấm điểm: danh sách sourceSpreadsheetId và criteria. Mỗi lần, bạn chỉ có thể sử dụng một trong các tiêu chí này để xác định tiêu chí chấm điểm.

Danh sách tiêu chí chấm điểm criteria được thay thế hoàn toàn bằng các tiêu chí chấm điểm được chỉ định trong yêu cầu cập nhật. Ví dụ: nếu thiếu tiêu chí hoặc cấp trong yêu cầu, thì tiêu chí hoặc cấp đó sẽ bị xoá. Thêm tiêu chí và cấp mới, đồng thời chỉ định một mã nhận dạng. Các tiêu chí và cấp hiện tại giữ lại mã nhận dạng được chỉ định trước đó nếu mã nhận dạng được chỉ định trong yêu cầu.

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

  • criteria
  • sourceSpreadsheetId

Đâ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 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 yêu cầu

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

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

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.