Learning Tools Interoperability (LTI) to otwarta platforma do tworzenia integracji innych firm w systemach zarządzania uczeniem. Dodatki do Classroom i narzędzia LTI obsługują podobne ścieżki użytkownika, ale te 2 platformy nie są ze sobą bezpośrednio zgodne. W tym przewodniku porównujemy 2 typy integracji i wskazujemy najważniejsze różnice. Zawiera też sugestie dotyczące osiągania podobnych ścieżek użytkownika podczas dostosowywania narzędzia LTI do działania jako dodatek do Classroom.
Interakcje między platformą a narzędziami
Kluczową różnicą między narzędziami LTI a dodatkami do Classroom jest sposób wymiany informacji. Narzędzia LTI zwykle używają protokołu HTTP POST do przesyłania ładunków do platformy LTI, a dodatki do Classroom tworzą i pobierają zasoby za pomocą interfejsu Google Classroom REST API.
W tabeli poniżej znajdziesz podsumowanie, jak osiągnąć kluczowe zachowania narzędzia LTI w Google Classroom.
| Funkcja | LTI | Classroom |
|---|---|---|
| tworzenia projektów, | Usługi związane z projektami i ocenami | Tworzenie zasobów CourseWork i AddOnAttachment |
| Opublikuj oceny | Usługi związane z projektami i ocenami | Poprawianie zadań przesłanych przez uczniów za pomocą funkcji CourseWork i AddOnAttachment |
| Uruchamianie tras | Precyzyjne linki | Określanie identyfikatorów URI w zasobach AddOnAttachment |
| Odczytywanie list uczestników kursu | Usługi udostępniania nazw i ról | Pobieranie profili Student i Teacher na kursie |
Dostosowywanie narzędzia LTI do dodatku do Classroom
Wiele interakcji LTI ma odpowiedniki w strukturze dodatków do Classroom. W kolejnych sekcjach omówimy najważniejsze pojęcia i zalecane działania.
Skonfiguruj aplikację
Wszystkie interakcje programowe z Google Classroom wymagają projektu Google Cloud. Konfiguracja strony aplikacji odbywa się w tym samym projekcie w chmurze, który określa, jak dodatek do Classroom będzie wyświetlany użytkownikom. Podasz ikony, ustawisz nazwę i opis aplikacji oraz skonfigurujesz uprawnienia zakresu OAuth wymagane przez Twoją usługę.
Zainstalowanie aplikacji dodatku z listy jest często jedynym krokiem konfiguracji, jaki muszą wykonać użytkownicy. Jest to analogiczne do włączenia i wdrożenia narzędzia LTI. Użytkownicy nie muszą wykonywać żadnych działań związanych z rejestracją ani zarządzać szczegółami konfiguracji, ale administrator może zezwolić na korzystanie z aplikacji w Marketplace i skonfigurować uprawnienia dostępu do danych innych firm.
Rekomendacja: postępuj zgodnie z naszym przewodnikiem, aby utworzyć i skonfigurować projekt Google Cloud na potrzeby dodatku do Classroom. Najważniejsze jest to, aby w pakiecie SDK Marketplace podać adres URL uruchamiania dodatku jako Attachment Discovery URI. Ten adres URL może być taki sam jak istniejąca ścieżka uruchamiania narzędzia LTI, o ile kieruje użytkownika do odpowiedniego procesu uwierzytelniania.
Proces uwierzytelniania
LTI korzysta z procedury dwuetapowej, w której aplikacja kliencka i serwer uwierzytelniania wymieniają podpisany token JWT. Użytkownicy nie muszą przyznawać narzędziu dostępu do swoich danych, ponieważ zgoda jest domniemana, gdy administrator skonfiguruje narzędzie.
Proces OAuth Google jest natomiast procesem trzyetapowym, w którym uczestniczą użytkownik, zewnętrzna aplikacja kliencka i serwer uwierzytelniania. Klient otrzymuje tokeny z wyraźną zgodą użytkownika, które przyznają dostęp do zasobów Google Classroom użytkownika.
Aplikacja dodatku może uzyskać podobne działanie 2-etapowego podpisywania JWT za pomocą kont usługi. Są to konta, które należą do aplikacji, a nie do indywidualnego użytkownika, i mogą podejmować działania bez zgody użytkownika. Korzystanie z kont usługi wymaga konfiguracji i zarządzania przez administratora. Używanie kont usługi z przekazywaniem dostępu w całej domenie jest zdecydowanie odradzane, ponieważ mogą one być wykorzystywane do nadużyć. Więcej informacji znajdziesz w naszym przewodniku po przekazywaniu dostępu w całej domenie w przypadku integracji z Google Classroom.
Rekomendacja: gdy adres URL powiązany z Twoim narzędziem lub dodatkiem otrzyma żądanie przychodzące, sprawdź, czy w żądaniu znajdują się parametry zapytania dodatku do Classroom. Jeśli jest dostępny, użyj pakietu SDK Google Identity, aby uzyskać dane logowania użytkownika. Zapisz dane logowania w sesji użytkownika i używaj ich do wysyłania kolejnych żądań do interfejsu Classroom API. Jeśli parametry zapytania nie są obecne, do interakcji z punktami końcowymi LTI platformy używaj żądań HTTP.
Tworzenie treści dodatkowych w Google Classroom
Dodatki do Classroom obsługują jeden typ treści: linki URL do stron hostowanych zewnętrznie. Te linki znajdują się w AddOnAttachmentzasobach, które określają ścieżki internetowe do otwarcia, gdy użytkownik wejdzie w interakcję z dodatkiem. Każdy adres URL otwiera się w określonych scenariuszach. Szczegółowe informacje znajdziesz w naszych przewodnikach po elementach iframe. Te adresy URL są analogiczne do linków do zasobów LTI.
Dodatki do Google Classroom nie obsługują innych typów treści, takich jak pliki, obrazy czy fragmenty HTML.
Rekomendacja: gdy użytkownik wybierze treści w Twojej usłudze, uzyskaj jego dane logowania OAuth i wyślij żądanie AddOnAttachments.create. Żądanie powinno zawierać obiekt AddOnAttachment z adresami URL widoku ucznia, widoku nauczyciela i (opcjonalnie) widoku oceniania. Pamiętaj, że istnieją oddzielne punkty końcowe interfejsu API do tworzenia załączników w ogłoszeniach, projektach i materiałach do zajęć. Tylko załączniki utworzone w projektach mogą mieć widok oceniania, ponieważ jest to jedyny typ elementu strumienia Classroom, który akceptuje zadania przesłane przez uczniów.
Porównanie funkcji platformy
Miejsca docelowe integracji
Dodatki do Classroom tworzą załączniki w ogłoszeniach, projektach i materiałach do zajęć. Są to elementy, które pojawiają się na karcie Stream w interfejsie Classroom.
Nauczyciele rozpoczynają proces tworzenia załącznika dodatku, wybierając dodatek w selektorze w procesie tworzenia projektu. Szczegółowe omówienie każdego widoku prezentowanego użytkownikom znajdziesz w przewodnikach dotyczących elementów iframe.
Deweloperzy mogą też tworzyć projekty automatycznie za pomocą załączników dodatków. Szczegółowe informacje znajdziesz w przewodniku po tworzeniu załączników poza Google Classroom.
Informacje o kontekście uruchomienia
Classroom dołącza do każdego adresu URL kilka parametrów zapytania podczas otwierania trasy dodatku. Zawsze zawierają one typ elementu strumienia oraz identyfikatory kursu i elementu strumienia. W zależności od widoku elementu iframe mogą być dostępne inne informacje, takie jak identyfikatory załącznika lub przesłanej próbki, token autoryzujący utworzenie załącznika lub adres URL umożliwiający przejście z linku na załącznik dodatku.
Classroom domyślnie nie przekazuje żadnych informacji o użytkowniku ani instytucji. Informacje o użytkowniku, w tym jego identyfikator, możesz uzyskać z zasobu UserProfile w Classroom API. Jeśli użytkownik jest administratorem domeny, informacje o instytucji możesz uzyskać z pakietu Workspace Admin SDK.
Uwierzytelnianie i autoryzacja
Dodatki do Classroom muszą używać funkcji Zaloguj się przez Google do uwierzytelniania użytkowników. Po zalogowaniu użytkownicy przyznają aplikacji uprawnienia za pomocą zakresów OAuth 2.0. Twoja aplikacja może używać dowolnej kombinacji dostępnych zakresów OAuth.
Odkrywanie i konfigurowanie aplikacji
Użytkownicy znajdują i „instalują” dodatki do Classroom w Google Workspace Marketplace. Instalacja jednym kliknięciem udostępnia aplikację dodatku poszczególnym nauczycielom. Opcjonalnie administrator może zainstalować aplikację dodatku dla wszystkich nauczycieli w jednostce organizacyjnej lub domenie. Załączniki utworzone w aplikacji są dostępne dla wszystkich uczniów na zajęciach. Użytkownicy nie muszą zarządzać tokenami, kluczami ani identyfikatorami poszczególnych dodatków do Classroom.
UX i przepływ produktu
W wielu przypadkach istniejący przepływ pracy narzędzia LTI dobrze sprawdza się jako dodatek do Classroom. Podobnie jak narzędzie LTI, dodatek do Classroom umożliwia tworzenie linków do treści na naszej platformie i zarządzanie nimi. Załączniki dodatków do Classroom są podobne do precyzyjnych linków LTI. Jeśli narzędzie LTI tworzy adresy URL, które prowadzą do hostowanych przez Ciebie treści, powinno dobrze działać jako dodatek do Classroom.
Ocenianie zadań uczniów
Załączniki dodatków do Classroom można wyświetlać i oceniać w widoku oceniania w Classroom. Gdy dołączasz treści, które wymagają przesłania przez ucznia, udostępniasz student_work_review_uri, w którym nauczyciel może wyświetlić i ocenić pracę konkretnego ucznia. Różni się to od LTI, gdzie narzędzie definiuje tylko target_link_uri, które jest wspólne dla nauczycieli i uczniów. Wdrożenie dodatków do Classroom jest najbardziej podobne do nadchodzącej usługi sprawdzania przesłanych materiałów LTI.