Struktura ocen cząstkowych i znane ograniczenia

Jeśli nie znasz jeszcze ocen cząstkowych w Classroom, zapoznaj się z tymi artykułami w Centrum pomocy, aby dowiedzieć się więcej o ogólnej strukturze ocen cząstkowych i sposobie oceniania ocen cząstkowych w interfejsie Classroom.

Struktura oceny cząstkowej

Jest kilka ważnych kwestii, które warto podkreślić, gdy korzystasz z interfejsu API do interakcji z ocenami cząstkowymi:

  • Z danym elementem CourseWork powiązana jest (maksymalnie) jedna ocena cząstkowa, która jest unikalna dla elementu CourseWork (nie można jej udostępniać w CourseWork zasobach).
  • Ocena cząstkowa składa się z kryteriów składających się z poziomów. Ocena cząstkowa zawsze musi zawierać co najmniej 1 kryterium, a kryterium – zawsze co najmniej 1 poziom.
  • Poziomy mogą być punktowane (zawiera punkty) lub nie (bez punktów). W ramach oceny cząstkowej każdy poziom musi mieć punktację lub całkowitą liczbę punktów.
    • Jeśli poziomy są punktowane, wszystkie poziomy kryterium muszą mieć ustawioną unikalną wartość punktową. Punkty mogą być liczbami całkowitymi (np. 10) lub wartościami zmiennoprzecinkowymi (np. 9.99). Może to być 0. Wartości null nie są akceptowane. Poza tym ocena cząstkowa nie może zawierać jednego kryterium z jednym poziomem o wartości 0 punktów.
    • Jeśli poziomy nie mają punktów, pole punktów należy pominąć. Wartości null nie są akceptowane.
  • Kolejność kryteriów i poziomów jest jasna i odzwierciedla kolejność, w jakiej są one przedstawione w interfejsie Classroom.
    • Zwłaszcza poziomy punktowane muszą być zawsze sortowane według punktów w kolejności rosnącej lub malejącej.
  • Każda ocena cząstkowa może zawierać do 50 kryteriów i do 10 poziomów osiągnięć dla każdego kryterium.

Zmianie ulegają również obiekty przesłane przez uczniów:

  • Oprócz dotychczasowych właściwości draftGrade i assignedGrade zadanie przesłane przez ucznia za pomocą oceny cząstkowej ma właściwości draftRubricGrades i assignedRubricGrades. Odzwierciedlają one oceny cząstkowe (wybrane poziomy i punkty), które uczeń otrzymuje odpowiednio podczas oceniania z oceny cząstkowej, odpowiednio w wersji roboczej i przypisanej.
  • Obecnie te właściwości są dostępne tylko do odczytu. Oznacza to, że interfejsu API nie można używać do oceniania projektów, ale zadania ocenione można odczytywać w interfejsie Classroom.
  • Zadania przesłane przez uczniów z powiązaną oceną cząstkową zawierają pole rubricId. To pole zawiera najnowszą ocenę cząstkową powiązaną z elementem CourseWork i może się zmienić, jeśli nauczyciele usuną i odtworzy ocenę cząstkową.

Zachowania ocen cząstkowych

W miarę możliwości interfejs Classroom ma odzwierciedlać interfejs Classroom, aby zachować spójność, ale może to prowadzić do nieintuicyjnego działania programistów, o którym warto wspomnieć:

  • Oceny cząstkowe mają na celu ułatwienie oceniania bez ograniczania nauczycieli. Dzięki temu podczas oceniania projektu za pomocą oceny cząstkowej nauczyciel może wykonać te czynności:
    • Zignoruj ocenę cząstkową podczas oceniania.
    • Możesz zastąpić punkty kryterium, niezależnie od liczby punktów dostępnych na jego poziomach.
    • Wybieraj poziomy tylko dla podzbioru kryteriów.
    • Przypisz punkty do kryteriów bez wybierania odpowiedniego poziomu.
    • zmień łączną liczbę punktów za projekt, niezależnie od punktów, które pochodzą z oceny cząstkowej.

Nie wprowadza on też żadnych nowych funkcji. Innymi słowy, interfejs API nie obsługuje zachowań, których nie ma jeszcze interfejs Classroom. Na przykład interfejs API nie pozwala na wymuszanie stosowania ocen cząstkowych za projekty ani na zastąpienie przez nauczyciela możliwości edytowania ocen cząstkowych i przesłanych zadań, tak jak ma to obecnie miejsce.

Ograniczenia podczas oceniania

Istnieją również dodatkowe ograniczenia dotyczące edytowania ocen cząstkowych po rozpoczęciu przez nauczyciela oceniania. Po przejściu na klasyczną wersję możesz wprowadzać tylko te zmiany:

  • Możesz edytować tekst w przypadku tytułów i opisów kryteriów oraz poziomów i poziomów.
  • Kolejność poziomów może się zmieniać w ramach kryteriów.

Dodatkowe zakresy

Oceny cząstkowe można ręcznie eksportować do Arkuszy kalkulacyjnych Google, aby użyć ich ponownie przez nauczycieli.

Jeśli utworzysz lub zaktualizujesz ocenę cząstkową z tych arkuszy kalkulacyjnych (zobacz przykład w przewodniku), aplikacja musi zażądać zakresu https://www.googleapis.com/auth/spreadsheets.readonly lub https://www.googleapis.com/auth/spreadsheets. Pamiętaj, że zakresy spreadsheets są uważane za wrażliwe i mogą wymagać weryfikacji aplikacji.