Ramka iframe do wyszukiwania załączników to początkowy widok wyświetlany nauczycielowi po otwarciu dodatku podczas tworzenia zadania w Classroom. Załącznik to treść lub działanie, z którymi uczniowie mają wchodzić w interakcję.
W ramach kursu w Classroom nauczyciel tworzy nowy post (np. projekt, ogłoszenie lub pytanie) i wybiera dodatek z listy rozwijanej (rysunek 1).
Rysunek 1. Widok tworzenia projektu z możliwymi opcjami dodatków, które nauczyciel może dołączyć.
Gdy nauczyciel wybierze dodatek, Classroom utworzy ramkę iframe do wyszukiwania załączników i wczyta adres URL uruchamiania dodatku. Do adresu URL uruchamiania przekazywane są wszystkie odpowiednie parametry zapytania iframe (rysunek 2).
Rysunek 2. Przykład interfejsu wyszukiwania załączników w ramce iframe.
Widok wyszukiwania załączników traktuj jako stronę docelową dla nauczycieli w Twoim dodatku. Zazwyczaj nauczyciel używa aplikacji internetowej partnera w ramce iframe, aby wybrać treści do dołączenia do elementu strumienia. Aplikacja dodatku może ograniczać wyświetlane treści w zależności od tego, czy element strumienia jest ogłoszeniem, projektem czy materiałem do zajęć. Aplikacja dodatku wywołuje następnie interfejs Classroom API, aby utworzyć załącznik i dołączyć go do projektu.
Gdy nauczyciel skończy wybieranie i tworzenie załączników, dodatek wysyła ładunek postMessage z prośbą o zamknięcie ramki iframe. Ramka iframe zamyka się, a nauczyciel widzi załączniki, które może wyświetlić lub usunąć z projektu (rysunek 3). Nauczyciel kończy proces tworzenia, przypisując element strumienia uczniom.
Rysunek 3. Widok tworzenia projektu z 3 załącznikami dodatków typu aktywność.
Wskazówki dotyczące wrażeń użytkownika
- Po pierwszym otwarciu dodatek musi poprosić nauczyciela o zalogowanie się.
- Wszystkie wywołania interfejsu Classroom API wymagają logowania jednokrotnego w Google. Jeśli Twój produkt ma osobny system logowania, musisz połączyć konta.
- Nauczyciel musi mieć możliwość wyświetlenia podglądu załącznika w ramce iframe przed dokonaniem ostatecznego wyboru.
- Nauczyciel powinien mieć możliwość wyszukiwania lub przeglądania treści, które można dołączyć.
- Dodatek może udostępniać różne widoki, np. ostatnie treści, moje treści i filtrowanie według umiejętności.
- Dodatek musi umożliwiać utworzenie nowego elementu, który można dołączyć, w ramce iframe.
Stan licencjonowania
Jeśli Twój dodatek wymaga licencji na Twój produkt, nauczycielowi bez licencji należy wyświetlić wyraźny komunikat z informacją, jak może rozwiązać ten problem. Rozważ też ukrycie lub wyłączenie treści, które są niedostępne dla nauczyciela ze względu na ograniczenia licencyjne.