REST Resource: courses.courseWork.rubrics

Zasób: ocena cząstkowa

Oceny cząstkowe zadania. Ocena cząstkowa to przewodnik po ocenianiu, który służy do oceniania prac uczniów i przekazywania im opinii.

Więcej informacji znajdziesz w artykule Struktura ocen cząstkowych i znane ograniczenia.

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

  "sourceSpreadsheetId": string
}
Pola
courseId

string

Identyfikator kursu.

Tylko do odczytu.

courseWorkId

string

Identyfikator zadania, którego dotyczy ta ocena.

Tylko do odczytu.

id

string

Identyfikator oceny cząstkowej przypisany przez Classroom. Jest on unikalny wśród ocen cząstkowych dla odpowiedniego zadania.

Tylko do odczytu.

creationTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa utworzenia tego zestawu ocen cząstkowych.

Tylko do odczytu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej zmiany w tym zestawie ocen cząstkowych.

Tylko do odczytu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

criteria[]

object (Criterion)

Lista kryteriów. Każde kryterium to wymiar, na podstawie którego oceniana jest skuteczność.

previewVersion

enum (PreviewVersion)

Tylko dane wyjściowe. Wersja testowa interfejsu API używana do pobierania tego zasobu.

Opcje tworzenia oceny cząstkowej na podstawie istniejącego źródła. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
sourceSpreadsheetId

string

Tylko dane wejściowe. Wartość niezmienna. Identyfikator arkusza kalkulacyjnego w Arkuszach Google. Ten arkusz kalkulacyjny musi zawierać sformatowane ustawienia oceny cząstkowej. Zobacz Tworzenie i ponowne używanie kryteriów oceny za projekt. Użycie tego pola wymaga zakresu https://www.googleapis.com/auth/spreadsheets.readonly lub https://www.googleapis.com/auth/spreadsheets.

Koniec pól wykluczających się wzajemnie.

Kryterium

Kryterium oceny cząstkowej. Każde kryterium to wymiar, na podstawie którego oceniana jest skuteczność.

Zapis JSON
{
  "id": string,
  "title": string,
  "description": string,
  "levels": [
    {
      object (Level)
    }
  ],
  "learningGoal": {
    object (LearningGoal)
  }
}
Pola
id

string

Identyfikator kryterium.

Podczas tworzenia przypisywany jest identyfikator.

title

string

Nazwa kryterium.

description

string

Opis kryterium.

levels[]

object (Level)

Lista poziomów w ramach tego kryterium.

learningGoal

object (LearningGoal)

Opcjonalnie:

Cel edukacyjny powiązany z tym kryterium. Pamiętaj, że cele edukacyjne dołączone do kryteriów oceny cząstkowej muszą być już dołączone do projektu, z którym są powiązane kryteria oceny cząstkowej. To pole jest wypełniane tylko wtedy, gdy ustawiono odpowiednią wartość previewVersion.

Poziom

Poziom kryterium.

Zapis JSON
{
  "id": string,
  "title": string,
  "description": string,
  "points": number
}
Pola
id

string

Identyfikator poziomu.

Podczas tworzenia przypisywany jest identyfikator.

title

string

Nazwa poziomu.

Jeśli poziom nie ma ustawionych punktów, musisz ustawić tytuł.

description

string

Opis poziomu.

points

number

Opcjonalne punkty powiązane z tym poziomem. Jeśli ta opcja jest ustawiona, wszystkie poziomy w ocenie cząstkowej muszą mieć określone punkty, a wartość musi być różna na wszystkich poziomach w ramach jednego kryterium. 0 to nie to samo co brak punktów.

Metody

create

tworzyć oceny cząstkowe,

delete

Usuwa ocenę cząstkową.

get

Zwraca ocenę cząstkową.

list

Zwraca listę ocen cząstkowych, które osoba wysyłająca żądanie może wyświetlić.

patch

Aktualizuje ocenę cząstkową.