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 kilka ważnych kwestii:

  • Z każdym CourseWork jest powiązana co najwyżej 1 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 kryteriach oceny 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 kryteria oceny nie mogą 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 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żdych kryteriów oceny i do 10 poziomów osiągnięć dla każdego kryterium.

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

  • 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 wersji roboczej i przypisania.
  • 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żesz odczytywać przesłane prace ocenione w interfejsie Classroom.

Działania związane z ocenami cząstkowymi

Interfejs API ma na celu odzwierciedlenie 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ą kryteriów oceny:
    • Całkowicie zignoruj kryteria oceny podczas oceniania.
    • Zastąp punkty kryterium niezależnie od liczby punktów dostępnych na poszczególnych 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 wynikałyby z kryteriów oceny.

Ponadto interfejs API nie obsługuje funkcji, których nie ma już interfejs 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ą pewne 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 ręcznie eksportować do Arkuszy Google, aby nauczyciele mogli ich ponownie używać.

Jeśli utworzysz lub zaktualizujesz kryteria oceny 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 wrażliwe i mogą wymagać weryfikacji aplikacji.

Materiały dydaktyczne innych firm

Kryteria oceny mogą być tworzone tylko przez projekt w chmurze Google, 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 materiałów dydaktycznych utworzonych 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 zapoznać się z wymaganiami wstępnymi interfejsu Classroom API i poprosić o konto demonstracyjne na potrzeby programowania, kliknij ten link.

Wstecz
Okresy oceniania