Wymagania dotyczące dodatków

Wersja 1.1 z 5 grudnia 2024 r.

Kryteria na tej stronie dotyczą wszystkich dodatków do Classroom. Dodatek musi spełniać wszystkie wymagania, aby można było go zatwierdzić do wyświetlania w Google Workspace Marketplace. Dodatek musi też „działać z Classroom”.

Słowa kluczowe „MUST” (musi), „MUST NOT” (nie musi), „REQUIRED” (wymagane), „SHALL” (musi), „SHALL NOT” (nie musi), „SHOULD” (zalecane), „MAY” (można) i „OPTIONAL” (opcjonalnie) w tym dokumencie należy interpretować zgodnie z opisem w specyfikacji RFC 2119.

Wymagania

Identyfikator Typ
1.0 Licencja użytkownika (jeśli dotyczy)
  1.1 Użytkownikowi, który nie ma licencji, NALEŻY wyświetlić przyjazny komunikat. W wiadomości NALEŻY wyraźnie podać powód, dla którego nie można używać dodatku, oraz zasugerować użytkownikowi sposób rozwiązania problemu. POLECANE
  1.3 Informacje o dodatku na stronie Google Workspace Marketplace powinny zawierać szczegóły dotyczące wymagań dotyczących licencji i subskrypcji, które mogą być wymagane do korzystania z dodatku. Jeśli dodatek ma płatny poziom, w opisie na stronie Marketplace POWINIEN znajdować się link do strony internetowej zawierającej więcej informacji o cenach lub sposobach kontaktu ze sprzedawcą. POLECANE
2.0 Logowanie użytkownika
  2.1 Użytkownicy nauczyciele MUSZĄ logować się w dodatku przy użyciu logowania jednokrotnego Google.
Jeśli uczniowie zostaną poproszeni o zalogowanie się w dodatku, MUSZĄ użyć logowania jednokrotnego Google.
WYMAGANE
  2.2 W przypadku kolejnych wizyt użytkownik MUSI logować się automatycznie za pomocą logowania jednokrotnego Google bez wyświetlania prośby o logowanie.
Jeśli podpowiedź logowania nie znajdzie dopasowania do aktualnie zalogowanego użytkownika, dodatek MUSI wyświetlić użytkownikowi przycisk logowania i przekazać parametr login_hint do biblioteki uwierzytelniania, aby odfiltrować nieprawidłowe konta.
WYMAGANE
  2.7 Jeśli użytkownik Classroom nie jest jeszcze zalogowany w dodatku (co można sprawdzić, patrząc na podpowiedź logowania), dodatek MUSI wyświetlać przycisk „Zaloguj się przez Google”, aby użytkownik mógł zalogować się w sposób jawny.
Uwaga: jest to konieczne, aby zachować zgodność z wytycznymi dotyczącymi marki Google. Pomaga to też uniknąć blokowania wyskakujących okienek.
WYMAGANE
  2.8 W dodatku POWINIEN być wyświetlany aktualnie zalogowany użytkownik. POLECANE
3.0 Ogólne
  3.1 Dodatek MUSI być zgodny z ogólnymi wytycznymi dotyczącymi zatwierdzania w Google Workspace Marketplace. WYMAGANE
  3.2 Jeśli zadanie jest uruchamiane w nowej karcie lub oknie z dowolnej ścieżki z wykorzystaniem ramki, POWINNA wyświetlać użytkownikowi wiadomość z instrukcjami powrotu do Classroom. POLECANE
  3.3 Użytkownik MUSI przejść całą ścieżkę, korzystając z procesu pracy z dodatkiem, a nie przełączać się na proces pracy z kursem ani używać przycisku udostępniania w Classroom. WYMAGANE
  3.4 Wybór lokalizacji: język powinien być ustawiony na podstawie preferencji lokalnych określonych przez przeglądarkę (jeśli są dostępne). POLECANE
  3,5 Jeśli dodatek definiuje maxPoints, MUSI on też ustawiać pointsEarned, gdy uczeń prześle pracę, używając zapisanych danych logowania nauczyciela (zalecane) LUB gdy nauczyciel otworzy pracę w ramce recenzji pracy ucznia. WYMAGANE
  3,9 Dodatki POWINNY być zgodne z wytycznymi WCAG 2.1 dotyczącymi ułatwień dostępu na poziomie AA. W momencie przesyłania deweloperzy dodatków muszą samodzielnie potwierdzić, że spełniają ten wymóg, a dodatek będzie nadal zgodny z przyszłościowymi zmianami. POLECANE
  3.10 Wszelkie błędy wyświetlane użytkownikowi POWINNA być zrozumiałe dla człowieka. POLECANE
  3.11 Jeśli studentViewUri, teacherViewUri lub studentWorkViewUri jest uruchamiane z skopiowanego projektu lub skopiowanego kursu, dodatek NIE MOŻE wyświetlać strony z błędem w iFrame. WYMAGANE
4,0 Odkrywanie załączników
  4,1 Jeśli załącznik wymaga przesłania przez ucznia, musi zawierać studentWorkReviewUri, aby był traktowany jako załącznik typu aktywność, a nie typu treść. WYMAGANE
  4.2 IFrame Discovery z załącznikami MUSI zawierać interfejs użytkownika, który oferuje co najmniej jedną z tych opcji:
  • Tworzenie nowych treści do załączenia
  • Przeglądanie, wybieranie i dołączanie plików z biblioteki treści
  • Instrukcje dotyczące dołączania treści z witryny lub innych usług
WYMAGANE
  4.3 Nauczyciel powinien mieć możliwość znalezienia wszystkich treści i aktywności dostępnych dla niego. POLECANE
  4.4 Nauczyciel powinien mieć możliwość wyświetlenia podglądu treści lub aktywności, zanim zdecyduje się na ich dołączenie do projektu. POLECANE
  4,5 Jeśli nauczyciel musi wykonać pracę, aby utworzyć treści lub aktywność, zanim będzie można je dołączyć, powinien to zrobić w ramach iframe. POLECANE
5.0 Widok ucznia
  5.1 Gdy użytkownik uruchomi studentViewUri, dodatek NIE POWINIEN wyrzucać go z ramki iframe, aby wykonać zadanie.
Jeśli dodatek wyrzuca użytkownika z ramki iframe, MUSI wyświetlić wiadomość lub inny komunikat, który poinformuje uczniów, jak wrócić do Classroom.
POLECANE
  5.2 Jeśli aktywność dodatku pojawia się w ramce iframe, w ramce powinien znajdować się podgląd zadania. POLECANE
  5.3 Jeśli jest dostępny, przycisk lub link w zadaniu o nazwie Prześlij MUSI wywołać żądanie interfejsu API, aby przesłać pracę ucznia do sprawdzenia przez nauczyciela. WYMAGANE
6.0 Widok nauczyciela
  6.1 Nauczyciel powinien widzieć to, co zobaczy uczeń podczas wykonywania projektu. POLECANE
7,0 Sprawdzanie prac uczniów
  7.1 Jeśli zostanie uruchomiony element studentWorkReviewUri, dodatek MUSI wyświetlić pracę ucznia do sprawdzenia przez nauczyciela w ramach ramki. Materiały dodatkowe mogą zawierać linki do stron spoza elementu iframe. WYMAGANE
  7.2 Wtyczka NIE MOŻE umożliwiać nawigacji między uczniami w widoku studentWorkReviewUri. Nawigacja między uczniami MUSI odbywać się tylko w interfejsie Classroom. WYMAGANE
8.0 Pomoc dotycząca aplikacji mobilnej Classroom
  8.1 Gdy aplikacja mobilna Classroom uruchamia teacherViewUri, studentViewUri lub studentWorkReviewUri, adres URL MUSI otwierać natywną aplikację mobilną lub mobilną aplikację internetową partnera. W obu przypadkach musi zawierać precyzyjny link do odpowiedniej strony. Jeśli urządzenie nie jest obsługiwane, użytkownik musi zobaczyć komunikat informujący o tym, że urządzenie nie jest obsługiwane, oraz (w miarę możliwości) o tym, które urządzenia są obsługiwane. WYMAGANE
  8.2 Uczeń powinien mieć możliwość wykonania zadania na urządzeniu mobilnym. POLECANE
9,0 Funkcje dodatkowe
  9.1 Jeśli nauczyciele mogą wklejać linki do Twoich treści jako załączniki linków, uaktualnij linki do załączników dodatków. POLECANE
  9.2 Jeśli do tworzenia projektów poza Classroom używasz integracji z CourseWork, utwórz domyślnie załączniki dodatków dla wszystkich linków zgodnych z Twoim dodatkiem. POLECANE

Historia zmian

Wersja 1.1 Zaktualizowano 5 grudnia 2024 r.
1.1, 1.3, 3.2, 3.10, 4.4, 5.2 Zmieniono z WYMAGANE na ZALECANA.
3.12 Usunięto.
5.3 Zmieniono treść. Niedawna zmiana pozwala deweloperom dodatków na niezawodne przesyłanie prac uczniów za pomocą interfejsu API.
Wersja 1.0 Aktualizacja z 30 kwietnia 2024 r.
1.1 Połączono sekcje 1.1 i 1.2 w jeden wymóg.
2.1 Połączyliśmy punkty 2.1 i 2.5 w jeden wymóg.
2.2 Połączyliśmy punkty 2.2, 2.3 i 2.4 w jeden wymóg.
3,5 Połączyliśmy wersje 3.5, 3.6 i 3.7 w jeden wymóg.
3.10 Dodano wymóg, aby dodatek nigdy nie wchodził w stan nieczytelny lub nie do odzyskania.
3.11, 3.12 Połączyliśmy sekcje 5.5, 5.6, 6.3, 6.4, 7.5 i 7.6 w 2 nowe wymagania.
4.2 Rozwinęliśmy opis dozwolonych doświadczeń z Discovery w przypadku załączników.
4.3 Zmieniona numeracja, wcześniej 4.2. Zmieniono też wartość z WYMAGANE naZALECANE.
4.4 Zmieniono numer, poprzednio 4.3.
4,5 Przenumerowane, poprzednio 4.4.
5.2 Zmieniono numerację. Wcześniej 5.3.
5.3 Zmieniono numer, wcześniej 5.2.
9.1 Dodaliśmy rekomendację, aby wklejone linki przekształcać w załączniki.
9.2 Dodano rekomendację, aby domyślnie tworzyć załączniki dodatków podczas tworzenia projektów zajęć w sposób programowy.
2.6, 3.7, 3.8, 6.2, 7.3, 7.4 Usunięto.
Wersja 0.3 Zaktualizowano 22 listopada 2022 r.
2.3 Poprawka wskazówki dotyczącej logowania.
2.4 Opisałeś scenariusz, w którym wymagane jest wdrożenie hd.
3.2 Zmieniono treść sekcji „Podaj ścieżkę”.
5.5, 5.6, 6.3, 6.4, 7.5, 7.6 Dodano wymagane i zalecane wskazówki dotyczące treści kursu dla tych elementów: studentViewUri, teacherViewUri i studentWorkReviewUri.
Wersja 0.2 Zaktualizowano 29 października 2021 r.
1.3 Poprawiono tekst, aby był bardziej zrozumiały.
3.1 Dodano „Dodatek MUSI być zgodny z ogólnymi wytycznymi dotyczącymi zatwierdzania Google Workspace, które można znaleźć na stronie internetowej Google Workspace”.
3,9 WCAG zmienił wartość WYMAGANE na ZALECANE.
5.1 Zmieniono wartość z WYMAGANE na ZALECANE.
5.3 Dodano „Jeśli dodatki wystają poza iframe, w iframe MUSI być widoczny podgląd zadania”.
5.4 Dodano „Jeśli dodatek wypadnie z ramki iframe, POWINIEN pojawić się komunikat z prośbą o powrót do Classroom”.
8.1 Dodano „Jeśli urządzenie nie jest obsługiwane, użytkownikowi MUSI zostać wyświetlony komunikat informujący o tym, że urządzenie nie jest obsługiwane. W miarę możliwości należy też poinformować użytkownika, które urządzenia są obsługiwane”.
8.2 Zmieniono wymagania dotyczące zadań uczniów na urządzeniach mobilnych z „WYMAGANE” na „ZALECANE”.
Wersja 0.1 Zaktualizowano 22 września 2021 r.
  Pierwsza wersja.