Ten dokument przedstawia pojęcia związane z ocenianiem, które mają zastosowanie do interfejsu Classroom API.
Więcej informacji o ocenianiu przez nauczycieli w aplikacji Google Classroom znajdziesz w artykule Ocenianie i śledzenie projektów.
Zadania i prace uczniów
W Google Classroom uczniowie oddają StudentSubmissions
zadań CourseWork
w Course
. CourseWork
można ocenić lub odznaczyć. Jeśli CourseWork
ma ocenę, ma wartość maxPoints
, która pokazuje, ile punktów łącznie ma zadanie. Jeśli maxPoints
ma wartość zero lub nie jest określony, projekt nie jest oceniony.
W przypadku ocenionych projektów nauczyciele ustawiają ocenę draftGrade
w StudentSubmission
, zanim zwrócą projekt uczniowi. Gdy przesłane dane zostaną zwrócone w aplikacji Classroom, w StudentSubmission
zostanie automatycznie ustawiona wartość assignedGrade
, która jest taka sama jak bieżąca wartość draftGrade
. Deweloperzy mogą ustawić oba te pola i muszą emulować działanie aplikacji Classroom. Na przykład assignedGrade
nie może być ustawiony bez draftGrade
. Oba pola są reprezentowane za pomocą miejsc dziesiętnych. Jeśli nie są skonfigurowane, oznacza to, że nauczyciel nie ustawił jeszcze odpowiedniej oceny.
Przykłady kodu służącego do odczytywania, ustawiania i zwracania ocen znajdziesz w artykule Tworzenie ocen i zarządzanie nimi.
Uczniowie mogą przesłać kilka wersji tego samego projektu CourseWork
, a stan przesyłania i historia ocen są śledzone w StudentSubmission.submissionHistory
.
Spóźnione, usprawiedliwione i nieoddane prace zaliczeniowe
Gdy przypisujesz uczniom elementy CourseWork
, dla każdego z nich tworzony jest placeholder StudentSubmissions
, nawet jeśli nie wykonał on jeszcze odpowiedniego projektu. Nauczyciele mogą ustawić dueDate
w CourseWork
, a powiązane z nim StudentSubmissions
są oznaczone polem late
(ustawionym na true
), jeśli uczeń nie odda projektu przed tą datą. Nauczyciele mogą też wyłączyć przesyłanie projektów po terminie, korzystając z ustawienia w aplikacji Classroom.
Dodatkowo StudentSubmissions
, które nie zostały przesłane przed dueDate
, są oznaczone w dzienniku ocen w Classroom jako brakujące. Nauczyciele mogą też ręcznie oznaczać przesyłane projekty jako nieoddane w aplikacji Classroom. Nieoddane projekty są automatycznie oznaczane wartością draftGrade
, którą nauczyciel może zmienić, ale domyślnie jest ona równa 0.
Nauczyciel może oznaczyć nieoddane projekty jako ukończone lub zwolnione.
Domyślne pole StudentSubmissions
w przypadku zadań oznaczonych jako ukończone jest usuwane, dopóki nauczyciel nie ustawi nowego ręcznie.draftGrade
StudentSubmissions
oznaczone jako „Zwolniony” są usuwane z obliczeń ogólnej oceny, w tym z okresów oceniania.
Aby dowiedzieć się więcej o tym, jak nauczyciele mogą obsługiwać przesyłane prace, przeczytaj artykuł pomocy Ocenianie i zwracanie prac.
Ogólna ocena i systemy oceniania
Classroom obsługuje wiele systemów oceniania na potrzeby obliczania ogólnych ocen uczniów w ramach kursu. Oceny ogólne mogą być obliczane bezpośrednio na podstawie sumy punktów, według kategorii lub w ogóle nie mogą być obliczane.
Więcej informacji o różnych systemach oceniania znajdziesz w artykule Konfigurowanie oceniania.
Najważniejsze informacje:
- Zasób
Course
ma obiektgradebookSettings
z informacjami o ustawieniach oceny zajęć.calculationType
określa metodę obliczania kursu.displaySettings
określa, kto może zobaczyć ogólne oceny w aplikacji Classroom. W miarę możliwości warto uwzględnić to w swojej aplikacji. Jeśli na przykład uczniowie nie mogą zobaczyć swojej oceny ogólnej w Classroom, nie pokazuj jej w aplikacji.gradeCategories
zawiera listę kategorii oceniania skonfigurowanych dla kursu, w tym ich nazwy wyświetlane, procent wag i wartości punktowe domyślne dla odpowiednich projektów.
- Jeśli kurs używa ważonego oceniania, może być konieczne znormalizowanie wag w scenariuszach, w których nie ma kategorii. Jeśli na przykład wagi kategorii wynosiły 20% dla zadań domowych, 10% dla ćwiczeń i 70% dla testów, ale nie było żadnych ćwiczeń, Classroom dostosowuje wagi do około 22% dla zadań domowych i około 78% dla testów podczas obliczania ogólnych ocen. Jeśli chcesz odzwierciedlić ogólne oceny z Classroom w swojej aplikacji, musisz to zrobić.
Okresy oceniania
Nauczyciele mogą grupować CourseWork
projekty w ramach zajęć w odrębne przedziały czasowe zwane okresami oceniania. Okresy oceniania można wykorzystać do filtrowania zadań w widoku dziennika ocen oraz tworzenia osobnych grup na potrzeby obliczeń ogólnej oceny.
Na przykład nauczyciel może utworzyć okresy oceniania w semestrze „wiosna” i „jesień”. Ocena ogólna za wiosnę będzie obejmować tylko teStudentSubmissions
, które przypadają w tym okresie.
System oceniania ustawiony dla kursu obejmuje okresy oceniania. Jeśli w przypadku zajęć, w których używasz oceny według kategorii z uwzględnieniem wagi, okresy oceniania są ustawione na wiosnę i jesień, uczniowie będą mieć w rezultacie 3 zestawy ocen ogólnych:
- Ogólna ocena wszystkich projektów na kursie.
- Ogólna ocena wszystkich projektów w zakresie dat wiosny.
- Ogólna ocena wszystkich projektów w zakresie dat obejmujących okres jesienny.
Wszystkie trzy obliczają ocenę ogólną na podstawie kategorii ważonych.
Aby zapoznać się z tą funkcją, przeczytaj ogłoszenie dotyczące okresów oceniania.
Okresy oceniania rozszerzają CourseWork
o gradingPeriodId
, który identyfikuje okres oceniania, w którym projekt jest realizowany.
Aby dowiedzieć się, jak odczytywać okresy oceniania i zarządzać nimi za pomocą interfejsu API, zapoznaj się z przewodnikiem po interfejsie API okresów oceniania.
Oceny cząstkowe
Nauczyciele mogą tworzyć i kojarzyć Rubrics
z projektami CourseWork
oraz używać tych ocen cząstkowych jako wskazówki podczas oceniania odpowiednich projektów StudentSubmissions
.
Aby dowiedzieć się, jak nauczyciele mogą korzystać z kryteriów w Classroom, przeczytaj artykuł o kryteriach.
Kryteria uzupełniają zasób StudentSubmissions
o dodatkowe pola:
rubricId
identyfikuje rubrykę odpowiadającą przesłanemu formularzowiCourseWork
.draftRubricGrades
to kryteria i wartości zastępcze, które nauczyciel wprowadził przed zwróceniem projektu uczniowi.assignedRubricGrades
to kryteria i punkty, które uczeń otrzymuje po zwróceniu projektu przez nauczyciela.
Aby dowiedzieć się, jak zarządzać kartami ocen i odczytywać powiązane oceny za pomocą interfejsu API, zapoznaj się z przewodnikiem po interfejsie API Rubrics.
Skale oceniania
Classroom obsługuje spersonalizowane skale oceniania, dzięki którym nauczyciele mogą przekształcać oceny liczbowe w oceny literowe. Te ustawienia i odpowiednie dane są niedostępne w interfejsie API.