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 te 2 typy integracji i wskazujemy najważniejsze różnice. Podpowiadamy też, jak osiągnąć podobne ścieżki użytkownika, dostosowując narzędzie 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ą metody 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 |
|---|---|---|
| Tworzenie projektów | Usługi projektów i ocen | Tworzenie zasobów CourseWork i AddOnAttachment |
| Publikowanie ocen | Usługi projektów i ocen | Aktualizowanie przesłanych zadań uczniów w zasobach CourseWork i AddOnAttachment |
| Trasy uruchamiania | Precyzyjne linki | Określanie identyfikatorów URI w AddOnAttachment zasobach |
| Odczytywanie list uczniów | Usługi udostępniania nazw i ról | Pobieranie Student i Teacher profili w kursie |
Dostosowywanie narzędzia LTI do dodatku do Classroom
Wiele interakcji LTI ma odpowiedniki w platformie dodatków do Classroom. W sekcjach poniżej omawiamy niektóre kluczowe pojęcia i zalecane działania.
Konfigurowanie aplikacji
Wszystkie interakcje programowe z Google Classroom wymagają projektu Google Cloud. W tym samym projekcie w chmurze skonfigurujesz wpis aplikacji, 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 Twój produkt.
Zainstalowanie aplikacji dodatku z listy jest często jedynym krokiem konfiguracji, który muszą wykonać użytkownicy. Jest to analogiczne do włączania i wdrażania narzędzia LTI. Użytkownicy nie będą musieli wykonywać żadnych działań związanych z rejestracją ani zarządzać żadnymi szczegółami konfiguracji, chociaż administrator może być zmuszony zezwolić na aplikację w Marketplace i skonfigurować uprawnienia dostępu do danych innych firm.
Zalecenie: postępuj zgodnie z naszym przewodnikiem tworzenia i konfigurowania projektu Google Cloud na potrzeby dodatku do Classroom. Najważniejsze jest, aby w pakiecie SDK Marketplace określić adres URL uruchamiania dodatku jako Attachment Discovery URI (identyfikator URI wykrywania załączników). Ten adres URL może być taki sam jak istniejąca trasa uruchamiania narzędzia LTI, o ile kieruje użytkownika do odpowiedniego procesu uwierzytelniania.
Proces uwierzytelniania
LTI używa 2-etapowego procesu, w którym aplikacja kliencka i serwer uwierzytelniania wymieniają podpisany token JWT. Użytkownicy nie muszą przyznawać narzędziu dostępu do swoich danych, ponieważ zgoda jest domyślna, gdy administrator skonfiguruje narzędzie.
Z kolei proces OAuth Google jest 3-etapowy i obejmuje użytkownika, zewnętrzną aplikację kliencką 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 osiągnąć podobne 2-etapowe zachowanie podpisanego tokena JWT za pomocą kont usługi. Są to konta, które należą do aplikacji, a nie do użytkownika, i mogą wykonywać działania bez zgody użytkownika. Korzystanie z kont usługi wymaga konfiguracji i zarządzania przez administratora. Zdecydowanie odradzamy korzystanie z kont usługi z przekazywaniem dostępu w całej domenie, ponieważ mogą one być wykorzystywane do nadużyć. Więcej informacji znajdziesz w naszym przewodniku dotyczącym przekazywania dostępu w całej domenie w przypadku integracji z Google Classroom.
Zalecenie: gdy adres URL powiązany z Twoim narzędziem lub dodatkiem otrzyma żądanie przychodzące, sprawdź, czy zawiera ono parametry zapytania dodatku do Classroom query parameters. Jeśli tak, użyj pakietu Google Identity SDK, aby uzyskać dane uwierzytelniające użytkownika. Zapisz dane uwierzytelniające w sesji użytkownika i użyj ich do wysyłania kolejnych żądań do interfejsu Classroom API. Jeśli parametry zapytania nie są obecne, użyj żądań HTTP, aby wchodzić w interakcje z punktami końcowymi LTI platformy.
Tworzenie treści dodatku w Google Classroom
Dodatki do Classroom obsługują 1 typ treści: linki URL do stron hostowanych zewnętrznie. Linki te znajdują się w zasobach AddOnAttachment,
które określają trasy internetowe do otwierania, gdy użytkownik wchodzi w interakcje z Twoim
dodatkiem. Każdy adres URL otwiera się w określonych scenariuszach. Szczegółowe informacje znajdziesz w naszych
przewodnikach dotyczących ramek iframe. Te adresy URL są analogiczne do linków do zasobów LTI.
Dodatki do Classroom nie obsługują innych typów treści, takich jak pliki, obrazy czy fragmenty HTML.
Zalecenie: gdy użytkownik wybierze treści w Twoim produkcie, uzyskaj jego
dane uwierzytelniające 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 przesłane zadanie ucznia.
Porównanie funkcji platformy
Miejsca 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 Strumień kursu 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 wyświetlanego użytkownikom znajdziesz w przewodnikach dotyczących ramek iframe.
Deweloperzy mogą też programowo tworzyć projekty z załącznikami dodatków. Więcej informacji znajdziesz w naszym przewodniku dotyczącym tworzenia załączników poza Google Classroom.
Informacje o kontekście uruchomienia
Gdy otwierasz trasę dodatku, Classroom dołącza do każdego adresu URL kilka parametrów zapytania. Zawsze obejmują one typ elementu strumienia oraz identyfikatory kursu i elementu strumienia. W zależności od widoku ramki iframe mogą być dostępne inne informacje, takie jak identyfikatory załącznika lub przesłanego zadania, token autoryzujący tworzenie załącznika lub adres URL umożliwiający przejście z linku na załącznik dodatku.
Domyślnie Classroom nie przekazuje żadnych informacji o użytkowniku ani instytucji. Informacje o użytkowniku, w tym jego identyfikator, możesz uzyskać z zasobu UserProfile interfejsu Classroom API . Jeśli użytkownik jest administratorem domeny, informacje o instytucji możesz uzyskać za pomocą 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ą Twojej 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 za pomocą aplikacji są wtedy dostępne dla wszystkich uczniów w kursie. Użytkownicy nie muszą zarządzać tokenami, kluczami ani identyfikatorami poszczególnych dodatków do Classroom.
Ścieżka użytkownika i proces produktu
W wielu przypadkach dotychczasowy proces produktu narzędzia LTI dobrze sprawdza się jako dodatek do Classroom. Podobnie jak narzędzie LTI, dodatek do Classroom umożliwia tworzenie linków do Twoich treści na naszej platformie i zarządzanie nimi. Załączniki dodatków do Classroom są podobne do linków precyzyjnych LTI . Jeśli Twoje 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 zadania przez ucznia, podajesz adres student_work_review_uri, pod 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óry jest wspólny dla nauczycieli i uczniów. Implementacja dodatków do Classroom jest
najbardziej podobna do nadchodzącej usługi LTI Submission Review Service.