Struktura ocen cząstkowych i znane ograniczenia

Jeśli nie wiesz, czym są kryteria oceniania w Classroom, przeczytaj te artykuły w Centrum pomocy, aby dowiedzieć się więcej o ogólnej strukturze kryteriów oceniania oraz o tym, jak ocenić uczniów na podstawie kryteriów w interfejsie Classroom.

Struktura ocen cząstkowych

Podczas korzystania z interfejsu API do interakcji z kryteriami warto zwrócić uwagę na kilka ważnych kwestii:

  • CourseWork jest powiązana (maksymalnie) jedna reguła, która jest unikatowa dla tego CourseWork (nie można jej udostępniać w różnych zasobach CourseWork).
  • Składa się ona z kryteriów, które mają poziomy. Rubryka musi mieć co najmniej jedno kryterium, a kryterium musi mieć co najmniej jeden poziom.
  • Poziomy mogą być oceniane (mieć punkty) lub nieocenione (bez punktów). Poziomy muszą być w pełni ocenione lub całkowicie nieocenione w ocenie.
    • Jeśli poziomy mają przypisane punkty, wszystkie poziomy w kryterium muszą mieć unikalny zestaw wartości punktów. Punkty mogą być liczbami całkowitymi (np. 10) lub liczbami zmiennoprzecinkowymi (np. 9,99). Może to być 0. Wartości null nie są akceptowane. Dodatkowo w ocenie nie może być kryterium z jednym poziomem o wartości 0 punktów.
    • Jeśli poziomy nie są punktowane, pole punktów należy pominąć. Wartości null nie są akceptowane.
  • Kolejność kryteriów i poziomów ma znaczenie i odzwierciedla kolejność, w jakiej są one wyświetlane w interfejsie Classroom.
    • W szczególności poziomy punktacji muszą być zawsze sortowane według punktów w kolejności rosnącej lub malejącej.
  • Możesz utworzyć do 50 kryteriów dla każdej oceny cząstkowej i do 10 poziomów osiągnięć dla każdego kryterium.

Obiekty StudentSubmission obsługują pola związane z kryteriami oceny:

  • Oprócz dotychczasowych właściwości draftGrade i assignedGrade praca ucznia oceniona według kryteriów ma właściwości draftRubricGrades i assignedRubricGrades. Są to oceny według kryteriów (poziomy i wartości punktowe), które uczeń otrzymuje podczas oceniania według kryteriów 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 przesłanych prac, ale można odczytać prace ocenione w interfejsie Classroom.

Zachowania oceny cząstkowej

Interfejs API ma naśladować interfejs Classroom, aby zapewnić spójność. Może to jednak prowadzić do działania, które może być nieintuicyjne dla deweloperów. Warto więc wspomnieć o tych kwestiach:

  • Kryteria mają wspierać ocenianie, nie ograniczając przy tym nauczycieli. W związku z tym nauczyciel może wykonać te czynności podczas oceniania przesłanych prac z wykorzystaniem karty oceny:
    • Podczas oceniania całkowicie ignoruj kryteria.
    • Zmień punkty kryterium niezależnie od punktów dostępnych na poszczególnych poziomach.
    • Wybierz poziomy tylko dla podzbioru kryteriów.
    • Przypisywanie punktów do kryterium bez wybierania odpowiedniego poziomu.
    • zastąpienie łącznej liczby punktów projektu, niezależnie od liczby punktów, którą można uzyskać na podstawie kryteriów oceny;

Interfejs API nie obsługuje też zachowań, których nie ma już w interfejsie użytkownika Classroom. Na przykład interfejs API nie umożliwia narzucania używania kart oceny w projektach ani zastąpienia możliwości nauczyciela do edytowania kart oceny i przesyłanych prac, tak jak jest to możliwe obecnie.

Ograniczenia podczas oceniania

Podobnie w przypadku ocen cząstkowych obowiązują dodatkowe ograniczenia, gdy nauczyciel zacznie oceniać za ich pomocą. Po rozpoczęciu oceniania możliwe są tylko te zmiany:

  • W przypadku tytułów i opisów kryteriów oraz poziomów dozwolone są zmiany tekstowe.
  • Kolejność poziomów może się zmieniać w ramach kryteriów.

Dodatkowe zakresy

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

Jeśli tworzysz lub aktualizujesz kartę oceny za pomocą tych arkuszy kalkulacyjnych (zobacz przykład w przewodniku), 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.

Kursy zewnętrzne

Kryteria mogą być tworzone tylko przez projekt Google Cloud, który utworzył element nadrzędny CourseWork. Jest to szerszy wzór projektowania w interfejsie Classroom API, który zapobiega wpływowi różnych aplikacji na zasoby, które nie należą do nich.

Dotyczy to zasobów utworzonych przez użytkowników w aplikacji Classroom. Na przykład aplikacja nie może zarządzać kryteriami oceniania zadań domowych utworzonych przez nauczyciela w interfejsie Classroom, nawet jeśli aplikacja należy do tego samego nauczyciela. Jeśli to znacznie ogranicza możliwości korzystania z usługi, prześlij opinię w narzędziu do zgłaszania błędów.

Wymagania dotyczące licencji

Użytkownik może tworzyć, aktualizować i usuwać karty ocen za pomocą interfejsu Classroom API, jeśli są spełnione te warunki:

Aby dowiedzieć się więcej o tym, jak funkcje interfejsu API są udostępniane użytkownikom, oraz o wymaganiach wstępnych interfejsu Classroom API, zapoznaj się z tą sekcją i poproś o konto demo na potrzeby programowania.