Oceny

Ten dokument przedstawia pojęcia związane z ocenianiem, które mają zastosowanie do interfejsu Classroom API.

Więcej informacji o wystawianiu ocen i śledzeniu projektów znajdziesz w artykule Wystawianie ocen i śledzenie projektów.

Zadania i przesłane materiały

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 jest przyznanych za to zadanie. Jeśli właściwość maxPoints ma wartość 0 lub jest nieokreślona, projekt nie ma oceny.

W przypadku ocenionych projektów nauczyciele ustawiają ocenę draftGrade w StudentSubmission, zanim zwrócą projekt uczniowi. Gdy przesłanie zostanie zwrócone w aplikacji Classroom, w StudentSubmission zostanie automatycznie ustawiona wartość assignedGrade, która jest taka sama jak aktualna wartość draftGrade. Deweloperzy mogą ustawić oba te pola i muszą emulować działanie aplikacji Classroom. Na przykład nie można ustawić właściwości assignedGrade bez właściwości draftGrade. W obu polach są reprezentowane ułamki dziesiętne, a jeśli nie są skonfigurowane, wskazują, że nauczyciel nie ustawił jeszcze odpowiedniej oceny. Przykłady kodu czytania, ustawiania i zwracania ocen znajdziesz w artykule na temat tworzenia ocen i zarządzania 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;

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 po terminie za pomocą 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ć przesłane zadania jako nieoddane w aplikacji Classroom. Brakujące projekty są automatycznie oznaczane plakietką draftGrade, którą nauczyciel może dostosować, ale domyślną wartością jest 0.

Nauczyciel może oznaczyć nieoddane prace jako ukończone lub wytłumaczone. Domyślne pole draftGrade w przypadku zadań StudentSubmissions oznaczonych jako ukończone jest usuwane, dopóki nauczyciel nie ustawi nowego ręcznie. StudentSubmissionsoznaczone 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 przez uczniów treści, przeczytaj artykuł pomocy Ocenianie i zwracanie projektów.

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, ważone według kategorii lub w ogóle nieobliczane.

Przeczytaj artykuł na temat konfigurowania oceniania, aby poznać różne systemy oceniania wraz z przykładami.

Najważniejsze informacje:

• Zasób Course ma obiekt gradebookSettings z informacjami o ustawieniach oceny zajęć.
  • calculationType określa metodę obliczania kursu.
  • displaySettings określa, kto może wyświetlać 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 domyślne wartości punktowe za poszczególne projekty.
• Jeśli w danym kursie stosowane jest ocenianie ważone, może być konieczne znormalizowanie wagi w sytuacjach, gdy kategoria nie jest podana. 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 odzwierciedlać ogólne oceny z Classroom w swojej aplikacji, musisz to zrobić.

Okresy oceniania

Nauczyciele mogą grupować CourseWorkprojekty 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.

Nauczyciel może na przykład utworzyć okresy oceniania „wiosna” i „jesień”. Ogólna ocena za okres wiosenny będzie obejmowała tylko StudentSubmissions z zakresu dat wiosny.

System oceniania ustawiony dla zajęć obejmuje również okresy oceniania. Jeśli w przypadku zajęć, w których używane są wagi kategorii oceniania, okresy oceniania wiosna i jesień byłyby ustawione zgodnie z przykładem, uczniowie mieliby 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ą z uwzględnieniem kategorii ważonych.

Aby dowiedzieć się więcej o tej funkcji, 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.

Zapoznaj się z przewodnikiem po interfejsie API okresów oceniania, aby dowiedzieć się, jak odczytywać okresy oceniania i zarządzać nimi za pomocą interfejsu API.

oceny cząstkowe,

Nauczyciele mogą tworzyć i powiązywać elementy Rubrics z projektami typu CourseWork oraz używać tych ocen cząstkowych jako wskazówek podczas oceniania danego zadania typu StudentSubmissions.

Aby dowiedzieć się, jak nauczyciele mogą korzystać z kryteriów w Classroom, przeczytaj artykuł o kryteriach.

Rubryka rozszerza zasób StudentSubmissions o dodatkowe pola:

• rubricId identyfikuje rubrykę odpowiadającą przesłanemu formularzowi CourseWork.
• draftRubricGrades to kryteria i punktacje wskaźników zastępczych, które nauczyciel przygotował 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 API.

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.