Zadania w Classroom są nazywane elementami CourseWork i można je znaleźć na stronie Zadania w dowolnym kursie w Classroom. Istnieją 4 typy elementów Classwork, ale ten przewodnik skupia się tylko na typie „Zadanie”. Jeśli chcesz dowiedzieć się, jak zarządzać innymi typami zadań, przeczytaj nasz przewodnik po zarządzaniu zadaniami.
Google Classroom oferuje 2 sposoby integracji z przepływem pracy związanym z zadaniami: przycisk udostępniania w 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, natomiast interfejs Classroom API umożliwia kompleksowy przepływ pracy związany z zadaniami, który obejmuje tworzenie zadań, tworzenie i zarządzanie przesłanymi przez uczniów pracami oraz przekazywanie ocen.
Poniżej znajdziesz najważniejsze różnice między tymi 2 ofertami dla deweloperów. Omówimy różnice w implementacji i poszczególnych etapach cyklu życia projektu: tworzeniu projektu, przesyłaniu prac przez uczniów oraz ocenianiu i przekazywaniu opinii.
Cykl życia projektu
Zanim przejdziemy do różnic między przyciskiem udostępniania a interfejsem CourseWork API, zdefiniujmy najpierw cykl życia zadania w kontekście Classroom. Pomoże Ci to zrozumieć, jak nauczyciele i uczniowie korzystają z zadań w Classroom.
Podczas integracji z projektami w Classroomie należy pamiętać o 5 głównych krokach:
- Projekt został utworzony.
- Projekt zostanie udostępniony uczniom.
- Uczeń wykonuje projekt.
- Uczeń przesyła projekt nauczycielowi.
- Nauczyciel sprawdza i ocenia projekty.
Integracja z zadaniami w Classroom umożliwia nauczycielom i uczniom bezproblemową pracę w Classroom i aplikacjach innych firm. Zamiast zarządzać szczegółami projektu lub przesłanymi pracami uczniów, użytkownicy mogą polegać na Twojej aplikacji, która będzie zarządzać tymi szczegółami za nich.
Implementacja
Pierwsza różnica między przyciskiem udostępniania a interfejsem CourseWork API dotyczy implementacji. Z punktu widzenia dewelopera przycisk udostępniania jest łatwiejszym sposobem udostępniania treści w Classroom, ponieważ wymaga tylko dołączenia niezbędnego zasobu JavaScript i dodania tagu przycisku udostępniania. W najprostszej formie integracja przycisku udostępniania w Classroom może wyglądać jak poniższy fragment kodu:
<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>
Z kolei interfejs CourseWork API jest częścią interfejsu Google Classroom API REST API, który wymaga skonfigurowania i włączenia kluczy interfejsu API w konsoli Google Cloud oraz przestrzegania sprawdzonych metod integracji z interfejsem API. Jest to mniej istotne, jeśli Twoja platforma korzysta już z innych funkcji interfejsu Classroom API, takich jak zarządzanie listami uczniów.
Tworzenie i udostępnianie projektów
Zarówno przycisk udostępniania, jak i interfejs CourseWork API umożliwiają wykonanie 2 pierwszych kroków procesu przypisywania zadań, czyli utworzenie i udostępnienie zadania uczniom. Istnieją jednak między nimi istotne różnice, które należy wziąć pod uwagę przed wyborem rozwiązania.
Oba rozwiązania umożliwiają publikowanie linków lub plików jako zadań w Classroom. Jest to przydatne rozwiązanie dla nauczycieli, którzy w przeciwnym razie musieliby kopiować i wklejać treści między Classroom a aplikacją innej firmy. Oba rozwiązania umożliwiają publikowanie treści jako zadania, ale zastanów się, czy Twoja aplikacja potrzebuje elastyczności w zakresie publikowania tych treści jako innych typów zajęć, a nawet ogłoszeń.
Obie usługi udostępniają wszystkie typy postów w Classroom z wyjątkiem projektów w formie quizu. Poniżej znajdziesz podsumowanie wszystkich typów postów i informację o tym, czy są one widoczne.
| Typ posta | Przycisk Udostępnij | CourseWork API |
|---|---|---|
| Projekt | X | X |
| Projekt – test | ||
| Pytanie: Krótka odpowiedź | X | X |
| Pytanie: wielokrotnego wyboru | X | X |
| Materiał | X | X |
| Ogłoszenie | X | X |
Funkcje takie jak określanie tytułu i opisu mogą być też programowo określane przez aplikację w przypadku obu rozwiązań. Integracja przycisku udostępniania umożliwia użytkownikom ustawianie w wyskakującym okienku pól takich jak termin, temat, tryb indywidualny i liczba punktów, ale nie można ich ustawiać programowo przez aplikację innej firmy. Interfejs API udostępnia natomiast wszystkie te pola do odczytu i zapisu.
Modyfikowanie projektów
Jedną z zalet integracji z interfejsem Classroom API jest wyeliminowanie konieczności ręcznego synchronizowania przez użytkowników zmieniających się szczegółów zadań. Przycisk udostępniania nie ma funkcji aktualizowania ani usuwania zadań w sposób programowy, więc wszelkie potrzebne modyfikacje musi wprowadzić użytkownik w interfejsie Classroom.
Interfejs CourseWork API umożliwia modyfikowanie i usuwanie zadań utworzonych przez aplikację, a także pobieranie szczegółów wszystkich zadań opublikowanych na kursach użytkownika. Pamiętaj jednak, że elementów CourseWork nie utworzonych w tej samej konsoli dewelopera nie można modyfikować w tej konsoli. Ten model uprawnień obejmuje pozostałą część cyklu życia projektu, np.zarządzanie przesłanymi przez uczniów projektami i ocenami. Nie można uzyskać dostępu do tych elementów CourseWork.
Automatyczne synchronizowanie projektów
Dzięki powiadomieniom push Pub/Sub Twoja aplikacja może subskrybować powiadomienia, które wywołują zdarzenie, gdy nastąpią zmiany w elementach CourseWork i powiązanych z nimi pracach uczniów. Umożliwia to aplikacji łatwą synchronizację zadań, ponieważ nie trzeba ciągle sprawdzać, czy treści w Classroom zostały zaktualizowane.
Kończenie i przesyłanie projektów
Każdy projekt jest powiązany z N przesłanymi pracami uczniów, gdzie N to liczba uczniów, którym przypisano projekt. Innymi słowy, w przypadku każdego zadania jest powiązane zgłoszenie ucznia dla każdego ucznia, do którego można uzyskać dostęp za pomocą unikalnego identyfikatora. Te projekty uczniów są tworzone automatycznie i mogą być pobierane przez aplikację za pomocą punktów końcowych GET i LIST projektów uczniów.
Zarówno przycisk udostępniania, jak i interfejs CourseWork API umożliwiają dodawanie linków lub plików do przesłanej przez ucznia pracy w ramach projektu. Przycisk udostępniania umożliwia to za pomocą podobnego procesu jak w przypadku okna tworzenia projektu przez nauczyciela, a interfejs CourseWork API za pomocą punktu końcowego studentSubmissions.modifyAttachments. Ze względu na ograniczenia uprawnień interfejsu API opisane wcześniej ta funkcja jest jednak ograniczona do elementów CourseWork utworzonych przez Twoją aplikację. To samo ograniczenie nie dotyczy przycisku udostępniania – uczniowie mogą dodawać swoje prace do dowolnego projektu wybranego w Classroom.
Zakończenie procesu dla uczniów
Ograniczenie uprawnień do CourseWork nie jest przydatne w przypadku platform, które nie obsługują tworzenia projektów. Jedną z zalet jest jednak to, że platformy innych firm mogą uniemożliwić uczniom przesyłanie prac do nieprawidłowego projektu i zapominanie o oddaniu pracy, ponieważ tylko przycisk udostępniania jest ograniczony w zakresie możliwości oddawania projektów przez uczniów.
Sprawdzanie i ocenianie projektów
Ostatnia część cyklu życia projektu wraca do nauczyciela. Gdy uczniowie oddadzą projekt, nauczyciel może go sprawdzić w dowolny sposób. W przypadku plików przechowywanych na Dysku mogą je sprawdzić bezpośrednio w narzędziu do oceniania w Classroom. Nie można jednak uzyskać dostępu do aplikacji innych firm w narzędziu do oceniania w Classroom. W związku z tym nauczyciele muszą przełączać się między kartami podczas sprawdzania i oceniania prac.
Przycisk udostępniania nie oferuje obecnie rozwiązania do oceniania i zwracania zadań. Chociaż funkcje takie jak komentarze do zadań przesłanych przez uczniów nie są obecnie dostępne w interfejsie API, 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 (typy Assignment i Question). Są one dostępne tylko w formie liczbowej i można je przypisać jako ocenę roboczą lub końcową.
Podsumowanie różnic
Aby podsumować wszystko, co zostało omówione w poprzednich sekcjach, w tabeli poniżej znajdziesz porównanie przycisku udostępniania i interfejsu CourseWork API w 4 kategoriach omówionych powyżej: wdrażanie, tworzenie i udostępnianie projektów, wykonywanie i przesyłanie projektów oraz sprawdzanie i ocenianie projektów.
| Przycisk udostępniania | CourseWork API | |
|---|---|---|
| Implementacja | Wystarczy kilka wierszy kodu JavaScript, co sprawia, że wdrożenie jest proste i szybkie. | Wymaga skonfigurowania kluczy interfejsu API, włączenia interfejsów API w konsoli administracyjnej i dokładniejszego monitorowania. |
| Tworzenie i udostępnianie projektów |
|
|
| Kończenie i przesyłanie projektów |
|
|
| Sprawdzanie i ocenianie projektów | Brak obsługi określania ani zwracania ocen |
|