Projekty w Classroom są nazywane elementami CourseWork, które można znaleźć na stronie Zadania dowolnego zajęć w Classroom. Istnieją 4 typy elementów na stronie Zadania, ale w tym przewodniku skupimy się tylko na typie „Projekt”. Jeśli chcesz dowiedzieć się więcej o zarządzaniu innymi typami zadań, przeczytaj nasz przewodnik po zarządzaniu zadaniami.
Z funkcją pracy nad projektami można zintegrować Google Classroom na 2 sposoby: przycisk udostępniania Classroom i interfejs Classroom API. Przycisk udostępniania umożliwia użytkownikom udostępnianie treści jako dowolnego elementu strumienia w wyskakującym okienku Classroom, a interfejs Classroom API umożliwia cały proces przypisywania, który obejmuje tworzenie projektów, tworzenie projektów przesłanych przez uczniów i zarządzanie nimi, a także przekazywanie ocen.
Tutaj omówimy najważniejsze różnice między tymi 2 ofertami dla deweloperów. Dokładniej rzecz ujmując, omówimy różnice w implementacji i poszczególnych etapach cyklu życia projektu: tworzeniu projektów, przesyłaniu projektów przez uczniów oraz ocenianiu i udzielaniu opinii.
Cykl życia przypisania
Zanim przejdziemy do różnic między przyciskiem udostępniania a interfejsem CourseWork API, najpierw zdefiniujmy cykl życia projektu w kontekście Classroom. Dzięki temu dowiesz się, jak nauczyciele i uczniowie korzystają z projektów w Classroom.
Podczas integracji z projektami Classroom należy pamiętać o 5 głównych krokach:
- Projekt zostanie utworzony.
- Projekt jest udostępniany uczniom.
- Uczeń wykonuje projekt.
- Uczeń przesyła projekt nauczycielowi.
- Nauczyciel sprawdza i ocenia projekty.
Integracja z projektami Classroom umożliwia nauczycielom i uczniom bezproblemową współpracę między Classroom a aplikacjami innych firm. Zamiast zarządzać szczegółami projektu lub zadań przesłanych przez uczniów, użytkownicy mogą polegać na Twojej aplikacji, która będzie nimi zarządzać.
Implementacja
Pierwszym obszarem różnicy między przyciskiem udostępniania a interfejsem CourseWork API jest implementacja. Z perspektywy dewelopera przycisk udostępniania jest łatwiejszą metodą udostępniania treści w Classroom, ponieważ wymaga tylko umieszczenia niezbędnego zasobu JavaScriptu i dodania tagu przycisku udostępniania. W najprostszym przykładzie integracja przycisku udostępniania w Classroom może wyglądać tak:
<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>
Interfejs CourseWork API jest natomiast częścią interfejsu Google Classroom API typu REST API, który wymaga skonfigurowania i włączenia kluczy interfejsów API w konsoli Google Cloud oraz postępowania zgodnie ze sprawdzonymi metodami integracji z interfejsem API. Nie martw się, jeśli Twoja platforma wykorzystuje już inne funkcje interfejsu Classroom API, takie jak rostering.
Tworzenie i udostępnianie projektów
Choć zarówno przycisk udostępniania, jak i interfejs CourseWork API umożliwiają wykonanie 2 pierwszych kroków przepływu pracy przy projektowaniu, tworzenia i udostępniania projektu uczniom, przed wybraniem rozwiązania musisz rozważyć kilka istotnych różnic.
Podstawową cechą obu rozwiązań jest możliwość publikowania linków lub plików jako projektów w Classroom. Jest to bardzo przydatne rozwiązanie w przypadku nauczycieli, którzy w innym przypadku musieliby wykonać proces kopiowania i wklejania między Classroom a aplikacją innej firmy. Oba rozwiązania umożliwiają publikowanie treści w formie projektów, ale warto wziąć pod uwagę, czy aplikacja potrzebuje elastyczności umożliwiającej publikowanie tych treści jako innych typów zadań lub nawet ogłoszenia.
W obu rozwiązaniach dostępne są wszystkie typy postów w Classroom z wyjątkiem testów. Poniżej znajdziesz podsumowanie wszystkich typów postów i informacje o tym, czy są one ujawniane.
| Rodzaj posta | Przycisk Udostępnij | Interfejs API CourseWork |
|---|---|---|
| Projekt | X | X |
| Projekt – test | ||
| Pytanie: krótka odpowiedź | X | X |
| Pytanie: Wielokrotny wybór | X | X |
| Materiał | X | X |
| Ogłoszenie | X | X |
Funkcje takie jak określenie tytułu i opisu mogą być również określone w aplikacji w przypadku obu rozwiązań. Integracja przycisku udostępniania umożliwia użytkownikom ustawienie pól, takich jak termin, temat, tryb spersonalizowany i liczba punktów w wyskakującym okienku, ale nie można ich konfigurować automatycznie przez aplikację innej firmy. Interfejs API udostępnia z drugiej strony wszystkie te pola dla dostępu do odczytu i zapisu.
Modyfikowanie przypisań
Wyeliminowanie konieczności ręcznego synchronizowania przez użytkowników zmieniających się szczegółów projektów to jedna z zalet integracji z interfejsem Classroom API. Nie ma on funkcji automatycznego aktualizowania ani usuwania projektów, więc wszelkie niezbędne zmiany musi wprowadzić użytkownik za pomocą interfejsu Classroom.
Interfejs CourseWork API umożliwia zarówno modyfikowanie i usuwanie projektów utworzonych przez aplikację, jak i pobieranie szczegółów projektów opublikowanych na zajęciach użytkownika. Pamiętaj jednak, że elementów CourseWork, nie utworzonych w tej samej konsoli programisty, nie można modyfikować w tej konsoli. Ten model uprawnień obejmuje pozostałą część cyklu życia projektu, np. nie można zarządzać zadaniami uczniów i ocenami w przypadku tych elementów CourseWork.
Automatyczne synchronizowanie projektów
Dzięki powiadomieniom push Pub/Sub aplikacja może subskrybować powiadomienia, które aktywują zdarzenie w przypadku zmian w elementach CourseWork i powiązanych z nimi zadaniach uczniów. Dzięki temu aplikacja może łatwo synchronizować projekty, eliminując potrzebę ciągłego sprawdzania, czy treść w Classroom została zaktualizowana.
Kończenie i przesyłanie projektów
Każdy projekt jest powiązany z zadaniami przesłanymi przez N uczniów, gdzie N to liczba uczniów, którym ten projekt został przypisany. Inaczej mówiąc, do każdego projektu przydzielony jest osobny projekt danego ucznia, do którego można uzyskać dostęp za pomocą unikalnego identyfikatora. Zadania uczniów są tworzone automatycznie i mogą być pobierane przez aplikację razem z punktami końcowymi GET i LIST.
Zarówno przycisk udostępniania, jak i interfejs CourseWork API obsługują dodawanie linków lub plików do przesłanych przez ucznia projektów. Za pomocą przycisku udostępniania można to zrobić w podobny sposób jak w przypadku okna tworzenia projektów przez nauczyciela oraz interfejsu API CourseWork przy użyciu punktu końcowego studentSubmissions.modifyAttachments. Ze względu na wcześniej opisane ograniczenia uprawnień dotyczące interfejsów API ta funkcja jest ograniczona do elementów CourseWork utworzonych przez Twoją aplikację. To samo ograniczenie nie dotyczy przycisku udostępniania – uczniowie mogą dodawać swoje prace do dowolnych projektów wybranych w Classroom.
Kończenie przepływu pracy ucznia
Chociaż ograniczenie uprawnień CourseWork nie sprawdza się w przypadku platform, które nie obsługują tworzenia projektów, to jedną z korzyści jest to, że platformy innych firm mogą uniemożliwiać uczniom zarówno przesyłanie zadań, jak i zapomnienie oddania prac, ponieważ tylko przycisk udostępniania ogranicza możliwość oddawania projektów przez uczniów.
Sprawdzanie i ocenianie projektów
Ostatnia część cyklu życia projektu zwraca się do nauczyciela. Gdy uczniowie oddadzą projekty, nauczyciel może je sprawdzić w najodpowiedniejszy dla siebie sposób. Pliki przechowywane na Dysku mogą przeglądać bezpośrednio w Classroom. Nie można jednak uzyskać dostępu do aplikacji innych firm w usłudze oceniającej Classroom. Wynika to z tego, że podczas sprawdzania i oceniania projektów nauczyciele muszą poruszać się po wielu kartach.
Przycisk udostępniania obecnie nie umożliwia oceniania ani zwracania projektów. Funkcje takie jak komentarze do zadań uczniów nie są obecnie udostępniane przez interfejs API, ale ocenianie i zwracanie ocen uczniom jest możliwe za pomocą punktów końcowych studentSubmissions.patch i studentSubmissions.return. Oceny można określać tylko w przypadku elementów strumienia CourseWork (typów Projektów i pytań). Są one dostępne tylko w postaci liczbowej i można je przypisywać jako ocenę roboczą lub końcową.
Podsumowanie różnic
W tabeli poniżej znajdziesz porównanie przycisku udostępniania i interfejsu CourseWork API w podsumowaniu wszystkich informacji omówionych w poprzednich sekcjach: wdrażanie, tworzenie i udostępnianie projektów, uzupełnianie i przesyłanie projektów oraz sprawdzanie i ocenianie projektów.
| Przycisk udostępniania | Interfejs API CourseWork | |
|---|---|---|
| Implementacja | Kilka wierszy JavaScriptu, co sprawia, że wdrożenie jest proste i szybkie. | Wymaga skonfigurowania kluczy interfejsów API, włączenia interfejsów API w konsoli administracyjnej oraz bliższego monitorowania |
| Tworzenie i udostępnianie projektów |
|
|
| Kończenie i przesyłanie projektów |
|
|
| Sprawdzanie i ocenianie projektów | Brak możliwości określania lub zwracania ocen |
|