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 kursu w Classroom i wybiera dodatek z menu (ryc. 1).
Rysunek 1. Widok tworzenia projektu, w tym opcji dodatków, które nauczyciel może dołączyć.
Gdy nauczyciel wybierze dodatek, Classroom utworzy iframe z informacjami o załączniku i załaduje adres URL uruchamiający dodatek. Wszystkie odpowiednie parametry zapytania iframe są przekazywane do adresu URL uruchamiania (ryc. 2).
Rysunek 2. Przykład interfejsu wyszukiwania załączników w elementach iframe.
Potraktuj widok Odkrywanie załączników jako stronę docelową dla nauczycieli w Twoim dodatku. Nauczyciel zwykle używa aplikacji internetowej partnera w elemencie iframe, aby wybrać treści do załączenia do strumienia. Aplikacja dodatku może ograniczać wyświetlanie treści w zależności od tego, czy element strumienia jest ogłoszeniem, projektem czy materiałem z kursu. Następnie aplikacja dodatku wywołuje interfejs Classroom API, aby utworzyć załącznik i dołączyć go do projektu.
Gdy nauczyciel wybierze i utworzy załączniki, dodatek wyśle postMessage z prośbą o zamknięcie ramki. Ramka iframe zamyka się, a nauczyciel widzi załączniki, które może wyświetlić lub usunąć z projektu (ryc. 3). Nauczyciel kończy proces tworzenia, przypisując uczniom element strumienia.
Rysunek 3. Widok tworzenia projektu z 3 dodatkami typu aktywność
Wskazówki dotyczące wrażeń użytkowników
- Po pierwszym otwarciu dodatek musi poprosić nauczyciela o zalogowanie się.
- Jednokrotne logowanie w Google jest wymagane we wszystkich wywołaniach interfejsu Classroom API. Jeśli Twoja usługa ma osobny 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 i przeglądania treści do załączania.
- Dodatek może wyświetlać różne widoki, takie jak najnowsze treści, moje treści i filtrowanie według umiejętności.
- Dodatek musi umożliwiać tworzenie nowych elementów do załączania w ramach elementu iframe.
Więcej informacji o wymaganiach dotyczących doświadczeń użytkowników znajdziesz w kontrolnej liście wymagań dotyczących dodatków do Classroom.
Stan licencjonowania
Jeśli dodatek wymaga licencji na Twój produkt, powinien wyświetlać jasny komunikat wyjaśniający, jak nauczyciel bez licencji może rozwiązać tę sytuację. Rozważ też ukrycie lub wyłączenie treści, które nie są dostępne dla nauczyciela z powodu ograniczeń licencyjnych.