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:
- Z
CourseWork
jest powiązana (maksymalnie) jedna reguła, która jest unikatowa dla tegoCourseWork
(nie można jej udostępniać w różnych zasobachCourseWork
). - 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.
Powiązane pola przesłanych przez uczniów zadań
Obiekty StudentSubmission
obsługują pola związane z kryteriami oceny:
- Oprócz dotychczasowych właściwości
draftGrade
iassignedGrade
praca ucznia oceniona według kryteriów ma właściwościdraftRubricGrades
iassignedRubricGrades
. 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:
- Użytkownik przesyłający prośbę ma przypisaną licencję Google Workspace for Education Plus.
- Właściciel kursu ma przypisaną licencję Google Workspace for Education Plus.
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.