Sprawdzone metody

Zadbaj o lepsze wrażenia użytkowników, korzystając z tych przewodników dotyczących projektowania dodatków do Google Meet.

Sprawdzone metody autoryzacji

W przypadku wszystkich dodatków do Google Meet, które wymagają uwierzytelniania lub autoryzacji, zalecamy stosowanie tych sprawdzonych metod.

Korzystanie z funkcji „Zaloguj się przez Google”

Wielu użytkowników dodatków do Google Workspace będzie już zalogowanych w Google przed dołączeniem do spotkania. Dlatego udostępnienie logowania jednym dotknięciem od Google może zaoszczędzić użytkownikom kilka kliknięć podczas procesu logowania. Więcej informacji znajdziesz w artykule Zarządzanie metodami logowania w dodatku.

 Otwórz stronę logowania zewnętrznego w nowym oknie

Oprócz logowania przez Google 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 nadal będzie mógł zobaczyć połączenie w Meet i do niego wrócić, a liczba kliknięć będzie mniejsza.

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

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

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

Najłatwiejszym sposobem na rozpoczęcie pisania kodu do wywoływania interfejsów Google Workspace API jest skorzystanie z szybkiego wprowadzenia do JavaScriptu. To podejście jest zgodne ze sprawdzonymi metodami korzystania z logowania przez Google i okien dialogowych. Pamiętaj, że inicjowanie klienta tokena w JavaScript wymaga oddzielnego żądania zakresów, których aplikacja faktycznie używa w czasie działania. Aby zapewnić użytkownikom najlepsze wrażenia, te zakresy uprawnień powinny być zgodne z zakresami na stronie Konfiguracja aplikacji w Google Workspace Marketplace. Ta nadmiarowość zapewnia mechanizm rezerwowy w przypadku, gdy użytkownik cofnie zakresy.

Sprawdzone metody konserwacji

Poniższe 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.

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

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

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

 Tworzenie projektu Google Cloud na potrzeby środowiska testowego

Gdy dodatek do Google Meet zostanie opublikowany w Google Workspace Marketplace, wszystkie nowe wdrożenia dodatku do Google Meet będą natychmiast dostępne dla użytkowników Meet. Użytkownicy zobaczą te aktualizacje, gdy tylko opróżnią 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 oddzielnego projektu Google Cloud, który będzie publikowany prywatnie w Twojej organizacji. W tym projekcie Cloud będą hostowane środowiska testowe i deweloperskie dodatku do Google Meet. Dostęp do tego projektu w chmurze powinien być ograniczony do mniejszego zespołu, który bezpośrednio pracuje nad rozwojem 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 dodatku do Meet, dodając kolejne wdrożenia do projektu Google Cloud w środowisku testowym. Nowe wdrożenia powinny mieć manifesty wskazujące alternatywne środowiska aplikacji internetowej. Następnie zalecamy zainstalowanie każdego środowiska dodatku w ten sposób:

  • Wersja testowa: opublikuj wersję testową prywatnie, aby każdy w Twojej organizacji mógł pomóc w testowaniu.
  • Wersja deweloperska: 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 programistycznym zalecamy napisanie testów jednostkowych. Testy jednostkowe powinny obejmować:

  • Symulowanie 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ą wybranego frameworka do testowania w internecie.

Sprawdzone metody dotyczące wygody użytkowników

Te sprawdzone metody pomogą Ci stworzyć bardziej intuicyjny i dopracowany dodatek do Meet.

Zarządzanie wszystkimi stanami początkowymi w panelu bocznym

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

 Zamykanie panelu bocznego, gdy nie jest używany

Po rozpoczęciu działania przez wywołanie metody startActivity() powinieneś pozostawić otwarty panel boczny tylko wtedy, gdy jest on istotną częścią interfejsu użytkownika dodatku do Google Meet. Po otwarciu głównej sceny możesz zamknąć panel boczny, wywołując metodę unloadSidePanel().

Promowanie dodatku do Meet przez udostępnianie ekranu

Dodatki do Meet zapewniają lepsze wrażenia niż udostępnianie ekranu. Wielu użytkowników jest jednak przyzwyczajonych do korzystania z funkcji udostępniania ekranu w Meet. Jeśli użytkownik udostępni kartę z witryną, która hostuje dodatek do Meet, Meet może wyświetlić 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.

Wytyczne dotyczące projektowania logo

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

Używaj plików w formacie PNG o rozmiarze 256 x 256 pikseli.

Używaj przejrzystości.

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

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

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

Nie dodawaj do obrazu dopełnienia. Zamiast tego rozszerz obraz do granic pliku.