Ramka iframe wykrywania załączników to widok początkowy, który jest 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ę.
W ramach zajęć w Classroom nauczyciel tworzy nowy post (np. projekt, ogłoszenie lub pytanie) i wybiera dodatek z listy dodatków (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 wykrywania załączników i wczyta adres URL uruchamiania dodatku. Wszystkie odpowiednie parametry zapytania elementu iframe są przekazywane do adresu URL uruchomienia (rysunek 2).
Rysunek 2. Przykład interfejsu wykrywania załączników w elemencie iframe.
Widok Odkrywanie załączników to strona docelowa dla nauczycieli w dodatku. Zazwyczaj nauczyciel używa aplikacji internetowej partnera w elemencie iframe, aby wybrać treść do dołączenia do elementu 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 do kursu. Aplikacja dodatku wykonuje wywołania interfejsu Classroom API, aby utworzyć załącznik i dołączyć go do zadania.
Gdy nauczyciel skończy wybieranie i tworzenie załączników, dodatek wysyła postMessageładunek z prośbą o zamknięcie elementu iframe. Ramka iframe zamyka się i 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ść.
Kwestie związane z wrażeniami użytkowników
- Przy pierwszym otwarciu dodatek musi poprosić nauczyciela o zalogowanie się.
- Wszystkie wywołania interfejsu Classroom API wymagają logowania jednokrotnego w Google. 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 elemencie 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. najnowsze treści, moje treści i filtrowanie według umiejętności.
- Dodatek musi umożliwiać utworzenie nowego elementu dołączanego w ramce iframe.
Więcej informacji o wymaganiach dotyczących interfejsu znajdziesz na liście kontrolnej wymagań dotyczących dodatków do Classroom.
Stan licencjonowania
Jeśli dodatek wymaga licencji na Twój produkt, powinien wyświetlać się jasny komunikat wyjaśniający, jak nauczyciel bez licencji może rozwiązać ten problem. Możesz też ukryć lub wyłączyć treści, które nie są dostępne dla nauczyciela z powodu ograniczeń licencyjnych.