REST Resource: courses.courseWork.rubrics

Tài nguyên: Tiêu chí chấm điểm

Tiêu chí chấm điểm của bài tập trong khoá học. Tiêu chí chấm điểm là hướng dẫn chấm điểm dùng để đánh giá bài tập của học viên và đưa ra ý kiến phản hồi.

Để biết thêm thông tin, hãy xem bài viết Cấu trúc tiêu chí chấm điểm và các hạn chế đã biết.

Biểu diễn dưới dạng JSON 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "creationTime": string,
  "updateTime": string,
  "criteria": [
    {
      object (Criterion)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "sourceSpreadsheetId": string
}
Trường
courseId

string

Giá trị nhận dạng của khoá học.

Chỉ có thể đọc.
courseWorkId

string

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

Chỉ có thể đọc.
id

string

Giá trị nhận dạng do Lớp học chỉ định cho tiêu chí chấm điểm. Đây là tiêu chí chấm điểm duy nhất cho bài tập có liên quan trong khoá học.

Chỉ có thể đọc.
creationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi tiêu chí chấm điểm này được tạo.

Chỉ có thể đọc.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của thay đổi gần đây nhất đối với tiêu chí chấm điểm này.

Chỉ có thể đọc.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
criteria[]

object (Criterion)

Danh sách tiêu chí. Mỗi tiêu chí là một phương diện để đánh giá hiệu suất.
previewVersion

enum (PreviewVersion)

Chỉ có đầu ra. Phiên bản xem trước của API dùng để truy xuất tài nguyên này.
Các lựa chọn để tạo tiêu chí chấm điểm từ một nguồn hiện có. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
sourceSpreadsheetId

string

Chỉ có đầu vào. Không thể thay đổi. Mã nhận dạng của bảng tính trên Google Trang tính. Bảng tính này phải chứa các chế độ cài đặt tiêu chí chấm điểm đã được định dạng. Xem bài viết Tạo hoặc sử dụng lại tiêu chí chấm điểm cho một bài tập. Để sử dụng trường này, bạn cần có phạm vi https://www.googleapis.com/auth/spreadsheets.readonly hoặc https://www.googleapis.com/auth/spreadsheets.
Kết thúc các trường loại trừ lẫn nhau.

Tiêu chí

Một tiêu chí chấm điểm. Mỗi tiêu chí là một phương diện để đánh giá hiệu suất.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "title": string,
  "description": string,
  "levels": [
    {
      object (Level)
    }
  ],
  "learningGoal": {
    object (LearningGoal)
  }
}
Trường
id

string

Mã tiêu chí.

Khi tạo, một mã nhận dạng sẽ được chỉ định.
title

string

Tiêu đề của tiêu chí.
description

string

Nội dung mô tả tiêu chí.
levels[]

object (Level)

Danh sách các cấp trong tiêu chí này.
learningGoal

object (LearningGoal)

Không bắt buộc.

Mục tiêu học tập liên quan đến tiêu chí này. Xin lưu ý rằng mục tiêu học tập được đính kèm vào tiêu chí chấm điểm phải được đính kèm vào bài tập mà tiêu chí chấm điểm được liên kết. Trường này chỉ được điền sẵn nếu bạn đặt previewVersion thích hợp.

Cấp độ

Một cấp độ của tiêu chí.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "title": string,
  "description": string,
  "points": number
}
Trường
id

string

Mã cấp.

Khi tạo, một mã nhận dạng sẽ được chỉ định.
title

string

Tên cấp độ.

Nếu cấp không có điểm, bạn phải đặt tiêu đề.
description

string

Nội dung mô tả cấp độ.
points

number

Điểm liên kết với cấp này (không bắt buộc). Nếu được đặt, tất cả các cấp trong tiêu chí chấm điểm phải chỉ định điểm và giá trị phải khác biệt giữa tất cả các cấp trong một tiêu chí. 0 khác với không có điểm.

Phương thức

create

 Tạo tiêu chí chấm điểm.

delete

 Xoá tiêu chí chấm điểm.

get

 Trả về một tiêu chí chấm điểm.

list

 Trả về danh sách các tiêu chí chấm điểm mà người yêu cầu được phép xem.

patch

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