Logowanie to pierwsza interakcja użytkownika z dodatkiem, dlatego ważne jest, aby mógł on przejść przez ten proces jak najpłynniej. W sekcjach poniżej znajdziesz informacje o różnych interfejsach API logowania, parametrach zapytania związanych z logowaniem, sposobach radzenia sobie z blokowaniem wyskakujących okienek oraz planie testów, który możesz wykorzystać podczas programowania, aby mieć pewność, że postępujesz zgodnie z najlepszymi praktykami.
Szczegóły implementacji logowania jednokrotnego
Protokół OAuth 2.0 Google jest zgodny z wieloma stosami OAuth 2.0. Zdecydowanie zalecamy wdrożenie autoryzacji po stronie serwera, ponieważ jest to najbardziej bezpieczna opcja, która obsługuje używanie parametrów zapytania iframe.
Podczas implementowania logowania przez Google zapoznaj się ze wskazówkami technicznymi na stronie Google Identity Pamiętaj, aby przestrzegać wskazówek dotyczących marki w przypadku logowania przez Google. Pliki w formatach Sketch, SVG i EPS są dostępne do pobrania.
Testy logowania
Zanim prześlesz dodatek do sprawdzenia, użyj planu testów dodatków, aby sprawdzić, czy spełnia on wymagane standardy i czy radzi sobie ze znanymi przypadkami brzegowymi, zanim prześlesz dodatek do sprawdzenia. Te testy są ściśle powiązane z listą kontrolną wymagań dotyczących dodatków do Classroom i zawierają szczegółowe instrukcje, jak sprawdzić czy dodatek spełnia te wymagania. Są to te same testy, które są przeprowadzane podczas publikowania aplikacji.
Parametry zapytania logowania
Google Classroom udostępnia parametr zapytania login_hint, który ułatwia powtarzanie logowania. Więcej informacji znajdziesz w sekcji Parametry związane z logowaniem na stronie Parametry zapytania iframe. Przykładowy kod znajdziesz w
przewodniku Obsługa powracających użytkowników w naszych przewodnikach dla programistów.
Zarządzanie blokowaniem wyskakujących okienek
Logowanie do dodatku jest ułatwione dzięki oknu logowania. To okno wyświetla ekran wyboru konta i umożliwia użytkownikowi przyznanie uprawnień OAuth. Blokowanie wyskakujących okienek przez użytkownika może uniemożliwić mu ukończenie procesu logowania.
Rysunek 1. Przykład ekranu wyboru konta.
Aby rozwiązać ten problem, udostępnij użytkownikowi przycisk, który pozwoli mu pominąć blokowanie wyskakujących okienek. Ta interakcja umożliwia wyświetlenie okna logowania, dzięki czemu użytkownik może kontynuować proces logowania. Upewnij się, że przycisk, który udostępniasz, jest zgodny ze wskazówkami dotyczącymi marki w przypadku logowania.
Aby zaimplementować przycisk logowania z logo Google, który można kliknąć, aby otworzyć okno logowania, postępuj zgodnie z instrukcjami w przewodniku logowania w naszych przewodnikach dla programistów.
Logowanie na wiele kont
Przeglądarka, w której jednocześnie zalogowanych jest kilka kont, może zakłócić proces użytkownika dodatku. Użytkownicy mogą wylogować się ze wszystkich kont Google w bieżącej przeglądarce lub otworzyć Classroom w oknie incognito w Chrome, a następnie zalogować się na właściwe konto i ponowić próbę.
Jeśli z powodu problemu z logowaniem na wiele kont w dodatku zalogowany jest nieprawidłowy użytkownik,
wywołania interfejsu Classroom Add-ons API mogą się nie powieść i zwrócić błąd
InvalidAddOnToken. Jeśli otrzymasz taki błąd, poinformuj użytkownika, aby wylogował się ze wszystkich innych kont w przeglądarce lub otworzył Classroom w oknie incognito w Chrome.