Ponieważ logowanie się to pierwsza interakcja użytkownika z Twoim dodatkiem, ważne jest, aby mógł on bezproblemowo ukończyć proces. Przeczytaj poniższe sekcje, aby zapoznać się z różnymi interfejsami API logowania, parametrami zapytania związanymi z logowaniem i sposobem postępowania z blokadami wyskakujących okienek, a także z planem testów, którego możesz użyć podczas programowania, aby mieć pewność, że stosujesz sprawdzone metody.
Szczegóły implementacji logowania jednokrotnego
Protokół OAuth 2.0 od Google jest zgodny z wieloma stosami OAuth 2.0. Zdecydowanie zalecamy wdrożenie autoryzacji po stronie serwera, ponieważ jest to najwyższa opcja zabezpieczeń, która obsługuje parametry zapytania iframe.
Podczas wdrażania logowania przez Google zapoznaj się ze wskazówkami technicznymi na stronie tożsamości Google. Przestrzegaj wskazówek dotyczących promowania marki związanej z logowaniem się w Google. Do pobrania są dostępne pliki Sketch, SVG i EPS.
Testy logowania
Zanim prześlesz dodatek do sprawdzenia, skorzystaj z planu testów, aby sprawdzić, czy Twój dodatek spełnia wymagane standardy i czy obsługuje znane przypadki skrajne. Te testy dokładnie odzwierciedlają listę wymagań dotyczących dodatków do Classroom i zawierają szczegółowe instrukcje, jak sprawdzić, czy Twój dodatek spełnia te wymagania. To te same testy, z którymi aplikacja jest testowana podczas publikacji.
Parametry zapytania dotyczące logowania
Google Classroom udostępnia parametr zapytania login_hint, który ułatwia wielokrotne logowanie. Więcej informacji znajdziesz w sekcji dotyczącej parametrów logowania na stronie parametrów zapytania iframe. Przykładowy kod można znaleźć w przewodniku dla programistów dotyczącym ponownych wizyt w naszych przewodnikach dla programistów.
Zarządzanie blokowaniem wyskakujących okienek
Logowanie się w dodatku jest łatwiejsze dzięki oknie logowania. Jest w nim wyświetlany ekran wyboru kont i umożliwia użytkownikowi przyznanie uprawnień OAuth. Blokowanie wyskakujących okienek przez użytkownika może uniemożliwić ukończenie procesu logowania.
Rysunek 1. Przykład ekranu wyboru konta.
Aby rozwiązać ten problem, udostępnij użytkownikowi przycisk umożliwiający ominięcie blokowania wyskakujących okienek. Ta interakcja umożliwia wyświetlenie okna logowania, aby użytkownik mógł kontynuować logowanie. Upewnij się, że udostępniany przycisk jest zgodny ze wskazówkami dotyczącymi promowania marki dotyczącymi logowania się.
Aby zaimplementować przycisk logowania z logo Google, którego kliknięcie powoduje wyświetlenie okna logowania, postępuj zgodnie z instrukcjami logowania przedstawionymi w naszych instrukcjach dla programistów.
Wielokrotne logowanie
Korzystanie z dodatku w przeglądarce, w której jesteś zalogowanym jednocześnie na wiele kont, może zakłócić działanie dodatku. Użytkownicy mogą wylogować się ze wszystkich kont Google w bieżącej przeglądarce lub otworzyć Classroom w oknie incognito Chrome, zanim zalogują się na właściwe konto i spróbują ponownie wykonać operację.
Jeśli z powodu problemu z wielokrotnym logowaniem zaloguje się w dodatku nieprawidłowy użytkownik, wywołania interfejsu API dodatków do Classroom mogą zakończyć się błędem InvalidAddOnToken. Jeśli pojawi się taki błąd, poinstruuj użytkownika, aby wylogował się ze wszystkich innych kont w przeglądarce lub otworzył Classroom w oknie incognito Chrome.