Struktura ocen cząstkowych i znane ograniczenia

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

Struktura ocen cząstkowych

Podczas korzystania z interfejsu API do interakcji z rubrykami warto zwrócić uwagę na te ważne kwestie:

  • Z CourseWork jest powiązana co najwyżej jedna rubryka, która jest unikalna dla tego CourseWork (nie można jej udostępniać w ramach innych zasobów CourseWork).
  • Rubryka składa się z kryteriów, które zawierają poziomy. Rubryka musi zawsze zawierać co najmniej 1 kryterium, a kryterium musi zawsze zawierać co najmniej 1 poziom.
  • Poziomy mogą być oceniane (z punktami) lub nieoceniane (bez punktów). Poziomy muszą być w rubryce w całości ocenione lub w całości nieocenione.
    • 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ć 0. Wartości null nie są akceptowane. Dodatkowo ocena cząstkowa nie może zawierać jednego kryterium z jednym poziomem, który ma 0 punktów.
    • Jeśli poziomy nie są oceniane, 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.
    • Poziomy z punktacją 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 rubrykami:

  • Oprócz istniejących właściwości draftGrade i assignedGrade przesłana przez ucznia praca oceniona za pomocą rubryki ma właściwości draftRubricGrades i assignedRubricGrades. Są to oceny częściowe (wybrane poziomy i wartości punktowe), które uczeń otrzymuje podczas sprawdzania za pomocą kryteriów oceny w stanach odpowiednio wersji roboczej i przypisania.
  • Obecnie te właściwości są tylko do odczytu. Oznacza to, że interfejsu API nie można używać do oceniania przesłanych prac, ale możesz odczytywać przesłane prace ocenione w interfejsie Classroom.

Działania związane z ocenami cząstkowymi

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

  • Rubryki mają ułatwiać ocenianie, ale nie ograniczać nauczycieli. Dzięki temu nauczyciel może podczas oceniania przesłanego projektu za pomocą rubryki:
    • całkowicie ignorować ocenę cząstkową podczas oceniania;
    • Zastąp punkty kryterium niezależnie od liczby punktów dostępnych na poziomach kryterium.
    • Wybierz poziomy tylko dla podzbioru kryteriów.
    • Przypisywanie punktów do kryteriów bez wybierania odpowiedniego poziomu.
    • Zastąp łączną liczbę punktów za projekt niezależnie od punktów, które wynikają z oceny cząstkowej.

Interfejs API nie obsługuje też funkcji, których nie ma już w interfejsie Classroom. Na przykład interfejs API nie umożliwia wymuszania używania rubryk w przypadku zadań ani zastępowania możliwości edytowania rubryk i przesłanych prac przez nauczyciela, jak to ma miejsce obecnie.

Ograniczenia podczas oceniania

Podobnie istnieją dodatkowe ograniczenia dotyczące edytowania ocen cząstkowych po rozpoczęciu oceniania przez nauczyciela. Po rozpoczęciu oceniania można wprowadzać tylko te zmiany:

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

Dodatkowe zakresy

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

Jeśli tworzysz lub aktualizujesz rubrykę na podstawie tych arkuszy kalkulacyjnych (przykład znajdziesz w tym 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 poufne i mogą wymagać weryfikacji aplikacji.

Kursy innych firm

Rubryki może tworzyć tylko projekt Google Cloud, w którym utworzono element nadrzędnyCourseWork. Jest to szerszy wzorzec projektowy w interfejsie Classroom API, który zapobiega wpływaniu różnych aplikacji na zasoby, które nie należą do nich.

Dotyczy to również zasobów utworzonych przez użytkowników w aplikacji Classroom. Na przykład aplikacja nie może zarządzać kryteriami oceny projektu utworzonego przez nauczyciela w interfejsie Classroom, nawet jeśli ten sam nauczyciel jest właścicielem aplikacji. Jeśli to znacznie ogranicza Twój przypadek użycia, podziel się opinią w publicznym narzędziu do rejestrowania błędów.

Wymagania dotyczące licencji

Użytkownik może tworzyć, aktualizować i usuwać rubryki 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 sekcji Wymagania dotyczące użytkowników. Aby dowiedzieć się więcej o wymaganiach wstępnych interfejsu Classroom API, zapoznaj się z tym artykułem. Możesz też poprosić o konto demonstracyjne do celów programistycznych.

Wstecz
Okresy oceniania