Zadania w Classroom są nazywane elementami zajęć i można je znaleźć na stronie Zajęcia w dowolnym kursie w Classroom. Istnieją 4 typy elementów 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, a interfejs API Classroom 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 przesyłanie ocen.
Teraz omówimy 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 przez uczniów pracami, 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 perspektywy 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. Nie jest to tak 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 zadania i udostępnienie go 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. To bardzo 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 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 z quizem. 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 przypisań
Eliminacja konieczności ręcznego synchronizowania przez użytkowników zmieniających się szczegółów zadań to jedna z zalet integracji z interfejsem Classroom API. Przycisk udostępniania nie ma funkcji aktualizowania ani usuwania zadań za pomocą kodu, 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 przesłanych 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 okno tworzenia projektu przez nauczyciela, a interfejs CourseWork API za pomocą punktu końcowego studentSubmissions.modifyAttachments. Ze względu na opisane wcześniej ograniczenia uprawnień interfejsu API ta funkcja jest jednak ograniczona do elementów CourseWork utworzonych przez Twoją aplikację. To 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ń 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żliwiać 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. Aplikacje innych firm nie są jednak dostępne 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 udostępniane przez interfejs API, ocenianie i zwracanie tych 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 |
|
|
| Wykonanie i przesłanie projektów |
|
|
| Sprawdzanie i ocenianie projektów | Brak możliwości określania ani zwracania ocen |
|