Method: courses.courseWork.rubrics.patch

Cập nhậ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. Bạn không thể cập nhật bộ tiêu chí chấm điểm sau khi bắt đầu chấm điểm.

Người dùng yêu cầu và chủ sở hữu khoá học phải có quyền tạo tiêu chí chấm điểm. Để biết thông tin chi tiết, hãy xem các yêu cầu về việc cấp phép.

Yêu cầu này phải được thực hiện bằng 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 chính trong khoá học.

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, nếu người dùng không được phép thực hiện sửa đổi theo yêu cầu đối với thang điểm hoặc do 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 thang điểm.
  • INVALID_ARGUMENT nếu yêu cầu có định dạng không chính xác và đối với lỗi yêu cầu sau:
    • RubricCriteriaInvalidFormat
  • NOT_FOUND nếu khoá học, bài tập hoặc thang đ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.
  • INTERNAL nếu bạn đã bắt đầu chấm điểm theo thang đ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

Tham 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 thang điểm.

Tham số truy vấn

Tham số
updateMask

string (FieldMask format)

Không bắt buộc. Mặt nạ xác định những trường trên thang điểm cần cập nhật. Đâ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 cách để xác định tiêu chí của một thang điểm: danh sách sourceSpreadsheetId và criteria. Bạn chỉ có thể sử dụng một trong các loại điểm này tại mỗi thời điểm để xác định một thang điểm.

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

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

  • criteria
  • sourceSpreadsheetId

Đâ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 tính năng API mới được cung cấp cho nhà phát triển trong Chương trình xem 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 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.