REST Resource: courses.courseWork.rubrics

Resource: Rubric

The rubric of the course work. A rubric is a scoring guide used to evaluate student work and give feedback.

For further details, see Rubrics structure and known limitations.

JSON representation 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "creationTime": string,
  "updateTime": string,
  "criteria": [
    {
      object (Criterion)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  // Union field rubric_source can be only one of the following:
  "sourceSpreadsheetId": string
  // End of list of possible types for union field rubric_source.
}
Fields
courseId

string

Identifier of the course.

Read-only.
courseWorkId

string

Identifier for the course work this corresponds to.

Read-only.
id

string

Classroom-assigned identifier for the rubric. This is unique among rubrics for the relevant course work.

Read-only.
creationTime

string (Timestamp format)

Output only. Timestamp when this rubric was created.

Read-only.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Output only. Timestamp of the most recent change to this rubric.

Read-only.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
criteria[]

object (Criterion)

List of criteria. Each criterion is a dimension on which performance is rated.
previewVersion

enum (PreviewVersion)

Output only. The preview version of the API used to retrieve this resource.
Union field rubric_source. Options to create a rubric from an existing source. rubric_source can be only one of the following:
sourceSpreadsheetId

string

Input only. Immutable. Google Sheets ID of the spreadsheet. This spreadsheet must contain formatted rubric settings. See Create or reuse a rubric for an assignment. Use of this field requires the https://www.googleapis.com/auth/spreadsheets.readonly or https://www.googleapis.com/auth/spreadsheets scope.

Criterion

A rubric criterion. Each criterion is a dimension on which performance is rated.

JSON representation 
{
  "id": string,
  "title": string,
  "description": string,
  "levels": [
    {
      object (Level)
    }
  ]
}
Fields
id

string

The criterion ID.

On creation, an ID is assigned.
title

string

The title of the criterion.
description

string

The description of the criterion.
levels[]

object (Level)

The list of levels within this criterion.

Level

A level of the criterion.

JSON representation 
{
  "id": string,
  "title": string,
  "description": string,
  "points": number
}
Fields
id

string

The level ID.

On creation, an ID is assigned.
title

string

The title of the level.

If the level has no points set, title must be set.
description

string

The description of the level.
points

number

Optional points associated with this level. If set, all levels within the rubric must specify points and the value must be distinct across all levels within a single criterion. 0 is distinct from no points.

Methods

create

 Creates a rubric.

delete

 Deletes a rubric.

get

 Returns a rubric.

list

 Returns a list of rubrics that the requester is permitted to view.

patch

 Updates a rubric.