Struktura ocen cząstkowych i znane ograniczenia

Jeśli nie znasz kryteriów oceny w Classroom, zapoznaj się z tymi artykułami w Centrum pomocy, aby dowiedzieć się więcej o ogólnej strukturze kryteriów oceny i o tym, jak ocenia się za pomocą kryteriów oceny w interfejsie Classroom.

Struktura ocen cząstkowych

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

  • Z elementem CourseWork jest powiązana co najwyżej jedna kryteria oceny, która jest unikalna dla tego elementu CourseWork (nie można jej udostępniać w ramach zasobów CourseWork).
  • Ocena cząstkowa składa się z kryteriów, które z kolei składają się z poziomów. Kryteria oceny muszą zawsze zawierać co najmniej 1 kryterium, a kryterium musi zawsze mieć co najmniej 1 poziom.
  • Poziomy mogą być oceniane (mieć punkty) lub nieoceniane (bez punktów). W kryteriach oceny poziomy muszą być w całości oceniane lub w całości nieoceniane.
    • Jeśli poziomy są oceniane, wszystkie poziomy w kryterium muszą mieć ustawioną unikalną wartość punktową. Punkty mogą być liczbami całkowitymi (np. 10) lub zmiennoprzecinkowymi (np. 9,99). Może to być też 0. Wartości null nie są akceptowane. Ponadto kryteria oceny nie mogą mieć jednego kryterium z jednym poziomem, który ma 0 punktów.
    • Jeśli poziomy są nieoceniane, pole punktów należy pominąć. Wartości null nie są akceptowane.
  • Kolejność kryteriów i poziomów jest istotna i odzwierciedla kolejność, w jakiej są one przedstawiane w interfejsie Classroom.
    • W szczególności poziomy oceniane muszą być zawsze posortowane według punktów w kolejności rosnącej lub malejącej.
  • Każda ocena cząstkowa może mieć maksymalnie 50 kryteriów, a każde kryterium może mieć maksymalnie 10 poziomów osiągnięć.

StudentSubmission obiekty obsługują pola związane z ocenami cząstkowymi:

  • Oprócz dotychczasowych właściwości draftGrade i assignedGrade zadanie przesłane przez ucznia, które zostało ocenione za pomocą oceny cząstkowej, ma właściwości draftRubricGrades i assignedRubricGrades. Reprezentują one oceny cząstkowe (wybrane poziomy i wartości punktowe), które uczeń otrzymuje podczas oceniania za pomocą kryteriów oceny, odpowiednio w stanie roboczym i przypisanym.
  • Obecnie te właściwości są tylko do odczytu. Oznacza to, że nie można używać interfejsu API do oceniania zadań, ale można odczytywać zadania ocenione w interfejsie Classroom.

Zachowania związane z ocenami cząstkowymi

Interfejs API ma na celu odzwierciedlanie interfejsu Classroom, gdy tylko jest to możliwe, aby zapewnić spójność, ale może to prowadzić do zachowań, które mogą być nieintuicyjne dla programistów i o których warto wspomnieć:

  • Oceny cząstkowe mają ułatwiać ocenianie bez ograniczania nauczycieli. Dlatego nauczyciel może podczas oceniania zadania za pomocą oceny cząstkowej:
    • całkowicie zignorować kryteria oceny podczas oceniania;
    • zastąpić punkty za kryterium, niezależnie od punktów dostępnych na poziomach kryterium;
    • wybrać poziomy tylko dla podzbioru kryteriów;
    • przypisać punkty do kryterium bez wybierania odpowiedniego poziomu;
    • Zastąp łączną liczbę punktów za zadanie, niezależnie od punktów, które wynikają z kryteriów oceny.

Ponadto interfejs API nie obsługuje zachowań, których nie ma już w interfejsie Classroom. Na przykład interfejs API nie umożliwia wymuszania używania ocen cząstkowych w zadaniach ani zastępowania możliwości edytowania ocen cząstkowych i zadań przez nauczyciela, tak jak to jest obecnie możliwe.

Ograniczenia podczas oceniania

Podobnie istnieją dodatkowe ograniczenia dotyczące edytowania ocen cząstkowych po tym, jak nauczyciel zaczął ich używać do oceniania. Po rozpoczęciu oceniania można wprowadzić tylko te zmiany:

  • Można edytować tekst tytułów i opisów kryteriów oraz poziomów.
  • W ramach kryteriów można zmieniać kolejność poziomów.

Dodatkowe zakresy

Oceny cząstkowe można ręcznie eksportować do Arkuszy Google, aby nauczyciele mogli ich ponownie używać.

Jeśli tworzysz lub aktualizujesz kryteria oceny na podstawie tych arkuszy kalkulacyjnych (zobacz przykład w przewodniku), Twoja aplikacja musi poprosić o zakres 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 to be verified.

Materiały dydaktyczne innych firm

Kryteria oceny mogą być tworzone tylko przez projekt w chmurze Google Cloud, który utworzył element nadrzędny CourseWork. Jest to szerszy wzorzec projektowania w interfejsie Classroom API, który uniemożliwia różnym aplikacjom wpływanie na zasoby, które nie należą do nich.

Dotyczy to też zasobów utworzonych przez użytkowników w aplikacji Classroom. Na przykład aplikacja nie może zarządzać kryteriami oceny w przypadku materiałów dydaktycznych, które nauczyciel utworzył w interfejsie Classroom, nawet jeśli ten sam nauczyciel jest właścicielem aplikacji. Jeśli to znacznie ogranicza Twój przypadek uży cia, podziel się opinią w publicznym narzędziu do rejestrowania błędów.

Wymagania dotyczące licencji

Użytkownik może tworzyć, aktualizować i usuwać oceny cząstkowe za pomocą interfejsu Classroom API tylko wtedy, gdy spełnione są te warunki:

Więcej informacji o tym, jak funkcje interfejsu API są udostępniane użytkownikom, znajdziesz w artykule Kwalifikacje użytkowników. Aby dowiedzieć się więcej o wymaganiach wstępnych interfejsu Classroom API i poprosić o konto demonstracyjne na potrzeby programowania, zapoznaj się z tym artykułem.

Wstecz
Okresy oceniania