Iframe odkrywania załączników to początkowy widok wyświetlany nauczycielowi po otwarciu dodatku podczas tworzenia zadania w Classroom. Załącznik to treść lub aktywność, z którą uczniowie mają wejść w interakcję.
Nauczyciel tworzy nowy post (np. projekt, ogłoszenie lub pytanie) w ramach zajęć w Classroom i wybiera dodatek z listy. Przez krótki czas (kilka godzin) Classroom zezwala dodatkowi na dodawanie załączników do posta.
Rysunek 1. Widok tworzenia zadania, w tym opcji dodatków, które nauczyciel może dołączyć.
Gdy nauczyciel wybierze dodatek, Classroom utworzy iframe dodatku Discovery i załaduje adres URL uruchomienia dodatku. Wszystkie odpowiednie parametry zapytania w ramce są przekazywane do adresu URL uruchamiania.
Rysunek 2. Przykład interfejsu wyszukiwania załączników w elementach iframe.
Nauczyciel używa aplikacji internetowej partnera w ramach elementu iframe, aby wybrać załącznik. Aplikacja wywołuje interfejs Classroom API, aby dołączyć załącznik do projektu. Gdy nauczyciel zakończy wybieranie załączników, dodatek wyśle pakiet danych postMessage
z prośbą o zamknięcie ramki iframe.
Ramka iframe zostaje zamknięta, a nauczyciel może wyświetlić załączniki i wybrać, czy chce wyświetlić ich podgląd, czy usunąć je z projektu.
Rysunek 3. Widok tworzenia projektu z 3 załącznikami typu „Aktywność”
Zagadnienia związane z wygodą użytkownika w przypadku elementu iframe
- Po pierwszym otwarciu nauczyciel musi zalogować się w dodatku.
- Jednokrotne logowanie w Google jest wymagane we wszystkich wywołaniach interfejsu Classroom API. Jeśli Twoja usługa ma oddzielny system logowania, musisz połączyć konta.
- Nauczyciel musi mieć możliwość wyświetlenia podglądu załącznika w ramach iframe przed dokonaniem ostatecznego wyboru.
- Nauczyciel powinien mieć możliwość wyszukiwania treści do załączania lub przeglądania takich treści.
- Dodatek może wyświetlać różne widoki, np. Ostatnie treści, Moje treści i filtrowanie według umiejętności.
- Wtyczka musi umożliwiać tworzenie nowego elementu do załączania w ramkach iframe.
Więcej informacji o wymaganiach dotyczących interfejsu użytkownika znajdziesz w kontrolnej liście wymagań dotyczących dodatków do Classroom.
Wyświetlanie stanu licencji w ramce iframe
Jeśli dodatek wymaga licencji, a nauczyciel jej nie ma, musi wyświetlić mu jasną wiadomość z informacjami o dalszych krokach, które należy wykonać, aby rozwiązać problem. Ma to na celu uniknięcie nieporozumień wynikających z ograniczeń licencyjnych.
Zalecamy też, aby Twój dodatek:
- Wyświetla poziom licencji nauczyciela w ramce okna Attachment Discovery.
- Ukrywa lub wyłącza treści, które są niedostępne dla nauczyciela z powodu ograniczeń poziomu licencji.