Sprawdzone metody

Postępuj zgodnie z tymi wskazówkami dotyczącymi projektowania dodatków do Google Meet, aby zwiększyć wygodę użytkowników.

Sprawdzone metody autoryzacji

Zachęcamy do stosowania tych sprawdzonych metod w przypadku wszystkich dodatków do Google Meet, które wymagają uwierzytelnienia lub autoryzacji.

Korzystanie z funkcji „Zaloguj się przez Google”

Wielu użytkowników dodatków do Google Workspace zaloguje się w Google przed dołączeniem do spotkania. Dlatego udostępnienie opcji Google One Tap może zaoszczędzić użytkownikom kilku kliknięć podczas logowania. Więcej informacji znajdziesz w artykule Zarządzanie metodami logowania w dodatku.

Otwieranie strony logowania firmy zewnętrznej w nowym oknie

Oprócz logowania przez Google Twoja aplikacja może oferować dodatkowe mechanizmy logowania. W takim przypadku użyj okna dialogowego zamiast otwierania strony logowania w nowej karcie. Dzięki temu użytkownik będzie mógł nadal widzieć połączenie Meet i do niego wrócić, a także wykona mniej kliknięć.

Prawidłowe żądanie zakresów interfejsów API Google

Jeśli Twój dodatek do Meet wywołuje interfejsy API Google, to musisz podać pełną listę zakresów OAuth wymaganych przez dodatek. Możesz to zrobić na stronie Konfiguracja aplikacji w Google Workspace Marketplace. Po dodaniu tych zakresów użytkownicy zobaczą prośbę o zgodę podczas instalowania dodatku do Meet. Informuje ona, do jakich danych aplikacja będzie miała dostęp.

Przed opublikowaniem dodatku musisz też skonfigurować ekran zgody OAuth. Wymaga to dodania dokładnie tych samych zakresów autoryzacji co w konfiguracji aplikacji w Google Workspace Marketplace. Konfiguracja ekranu zgody OAuth wymaga też ustawienia informacji o marce, polityki prywatności i warunków korzystania, które są wyświetlane, gdy użytkownik prosi o zakresy. Aby opublikować publicznie, musisz przesłać wszystkie te informacje do weryfikacji.

Najłatwiejszym sposobem na rozpoczęcie pisania kodu do wywoływania interfejsów API Google Workspace jest skorzystanie z przewodnika Szybki start w JavaScript. To podejście jest zgodne ze sprawdzonymi metodami korzystania z funkcji „Logowanie przez Google” i okien dialogowych. Pamiętaj, że inicjowanie tokena klienta w JavaScript wymaga oddzielnego żądania zakresów, których aplikacja faktycznie używa w czasie działania. Aby zapewnić użytkownikom jak największą wygodę, te żądane zakresy powinny być zgodne z zakresami na stronie Konfiguracja aplikacji w Google Workspace Marketplace. Ta redundancja zapewnia rezerwę w przypadku, gdy użytkownik cofnie zakresy.

Sprawdzone metody konserwacji

Te sprawdzone metody dotyczą pisania aplikacji internetowych, które można łatwo utrzymywać, ale są szczególnie ważne w przypadku pisania dodatków do Meet.

Korzystanie z najnowszej wersji pakietu SDK dodatków do Google Meet

Pakiet SDK dodatków do Meet jest regularnie aktualizowany. Jest on zgodny z wersjonowaniem semantycznym. Aby znaleźć najnowszą wersję:

  • Jeśli używasz gstatic: najnowsza wersja pakietu SDK znajduje się w adresie URL gstatic , który znajdziesz w instrukcjach korzystania z pakietu SDK.
  • Jeśli używasz npm: w katalogu zawierającym plik package.json witryny, która hostuje Twój dodatek do Meet, uruchom polecenie npm update @googleworkspace/meet-add-ons.

Tworzenie projektu Google Cloud w środowisku przejściowym

Gdy dodatek do Google Meet zostanie opublikowany w Google Workspace Marketplace, wszystkie nowe wdrożenia tego dodatku będą natychmiast dostępne dla użytkowników Meet. Użytkownicy zobaczą te aktualizacje, gdy tylko wyczyszczą pamięć podręczną lub gdy wygaśnie jej ważność. Dlatego zalecamy, aby nie wprowadzać zmian w witrynie produkcyjnej, dopóki nie zostaną one dokładnie przetestowane.

Aby uniknąć wdrażania bezpośrednio w środowisku produkcyjnym, zalecamy utworzenie osobnego projektu w chmurze Google który będzie opublikowany prywatnie w Twojej organizacji. Ten projekt w chmurze będzie hostować środowiska przejściowe i deweloperskie dla Twojego dodatku do Meet. Dostęp do tego projektu w chmurze powinien być ograniczony do mniejszego zespołu, który bezpośrednio pracuje nad programowaniem Twojego dodatku.

Aby utworzyć te alternatywne środowiska dla dodatku, musisz najpierw hostować alternatywne środowiska aplikacji internetowej zawierającej dodatek w domenie, której jesteś właścicielem. Następnie, możesz utworzyć alternatywne środowiska dla swojego dodatku do Meet, dodając dodatkowe wdrożenia do projektu Google Cloud w środowisku przejściowym. Te nowe wdrożenia powinny mieć manifesty, które wskazują na alternatywne środowiska aplikacji internetowej. Następnie zalecamy zainstalowanie każdego środowiska dodatku w ten sposób:

  • Środowisko przejściowe: opublikuj wersję przejściową prywatnie aby każdy w Twojej organizacji mógł pomóc w testowaniu.
  • Środowisko deweloperskie: w kolumnie Działania kliknij Zainstaluj, aby zainstalować wersję deweloperską dodatku do Meet tylko na swoim koncie.

Pisanie testów

Przed wdrożeniem dodatku do Meet w środowisku deweloperskim zalecamy napisanie testów jednostkowych. Testy jednostkowe powinny obejmować:

  • Mockowanie pakietu SDK dodatków do Meet, a następnie sprawdzanie, czy dodatek do Meet wywołuje funkcje pakietu SDK zgodnie z oczekiwaniami.
  • Testowanie jednostkowe wszystkich funkcji dodatku niezwiązanych z pakietem SDK za pomocą preferowanego frameworka do testowania aplikacji internetowych.

Sprawdzone metody zapewniania wygody użytkowników

Te sprawdzone metody pomagają sprawić, aby dodatek do Meet był bardziej intuicyjny i dopracowany.

Zarządzanie całym stanem początkowym w panelu bocznym

Zdecydowanie zalecamy skonfigurowanie dodatku na podstawie działań użytkowników w panelu bocznym. Możesz to zrobić, ustawiając stan początkowy aktywności w JavaScript. Wszystkie dane, które trafiają do ActivityStartingState powinny być ustawiane przez inicjatora dodatku (zwykle gospodarza spotkania) w panelu bocznym. Pierwszy widok panelu bocznego możesz traktować jako formularz, który kontroluje konfigurację dodatku.

Zamykanie panelu bocznego, gdy nie jest używany

Po rozpoczęciu aktywności przez wywołanie metody startActivity() panel boczny powinien być otwarty tylko wtedy, gdy jest niezbędny do zapewnienia użytkownikom wygody korzystania z dodatku do Google Meet. Gdy otworzy się główny etap, możesz zamknąć panel boczny, wywołując unloadSidePanel() metodę.

Promowanie dodatku do Meet przez udostępnianie ekranu

Dodatki do Meet zapewniają lepsze wrażenia niż udostępnianie ekranu. Jednak wielu użytkowników jest przyzwyczajonych do korzystania z funkcji udostępniania ekranu w Meet. Jeśli użytkownik udostępni kartę wyświetlającą witrynę, która hostuje Twój dodatek do Meet, możesz skonfigurować Meet tak, aby wyświetlał baner wszystkim uczestnikom połączenia z prośbą o zainstalowanie lub użycie odpowiedniego dodatku do Meet. Więcej informacji znajdziesz w artykule Promowanie dodatku przez udostępnianie ekranu.

Wskazówki dotyczące projektowania logo

Podczas projektowania logo do Meet postępuj zgodnie z tymi wskazówkami, aby logo wyglądało jak najlepiej teraz i w przyszłości:

Używaj pliku w formacie PNG o wymiarach 256 x 256 pikseli.

Używaj przezroczystości.

Sprawdź, czy logo w trybie ciemnym wygląda dobrze w tym trybie, korzystając z narzędzi dla deweloperów dodatków do Meet.

Sprawdź, czy logo (i inne zasoby graficzne) wyglądają dobrze w trybie wysokiego kontrastu, korzystając z narzędzia do sprawdzania kontrastu, np. Contrast Checker firmy Web Accessibility In Mind (WebAIM).

Przestrzegaj wymagań dotyczących grafiki w przypadku konkretnych integracji aplikacji.

Nie dodawaj do obrazu dopełnienia. Zamiast tego rozciągnij obraz do granic pliku.