Sprawdzone metody

Aby poprawić ogólne wrażenia użytkowników, postępuj zgodnie z tymi wskazówkami dotyczącymi projektowania dodatków do Google Meet.

Sprawdzone metody autoryzacji

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

Korzystanie z logowania 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 Google jako opcji może pozwolić użytkownikom zaoszczędzić kilka kliknięć podczas procesu logowania. Więcej informacji znajdziesz w artykule Zarządzanie metodami logowania w przypadku dodatku.

 Otwórz stronę logowania usługi innej firmy w nowym oknie

Oprócz logowania w Google Twoja aplikacja może oferować dodatkowe mechanizmy logowania. Jeśli tak, użyj okna zamiast otwierania strony logowania w nowej karcie. Dzięki temu użytkownik będzie mógł zobaczyć i wrócić do rozmowy w Meet i uzyskać mniej kliknięć.

Poprawne żądanie zakresów interfejsów API Google

Jeśli dodatek do Meet wywołuje interfejsy API Google, musisz przekazać pełną listę zakresów OAuth wymaganych przez dodatek. Można to zrobić na stronie Konfiguracja aplikacji Google Workspace Marketplace. Po dodaniu tych zakresów podczas instalowania dodatku do Meet użytkownicy zobaczą prośbę o dostęp do danych, która informuje, do jakich danych ma dostęp Twoja aplikacja.

Zanim opublikujesz dodatek, musisz też skonfigurować ekran zgody OAuth. Wymaga to dodania dokładnie tych samych zakresów autoryzacji z konfiguracji aplikacji Google Workspace Marketplace. Skonfigurowanie ekranu zgody OAuth wymaga też ustawienia informacji o marce, polityki prywatności i warunków usługi, które są wyświetlane, gdy wymagane są zakresy. Aby opublikować treści publicznie, musisz przesłać te informacje do weryfikacji.

Gdy piszesz kod wywołujący interfejsy Google Workspace API, najprostszym sposobem jest zapoznanie się z krótkim wprowadzeniem do JavaScriptu. Takie podejście jest zgodne ze sprawdzonymi metodami korzystania z logowania w Google i oknem dialogowym. Pamiętaj, że inicjowanie klienta tokena w JavaScript wymaga osobnego zażądania zakresów, których aplikacja faktycznie używa w czasie wykonywania. Aby zapewnić użytkownikom najlepsze wrażenia, te żądane zakresy powinny być zgodne z tymi na stronie Konfiguracja aplikacji Google Workspace Marketplace. Ta nadmiarowość zapewnia możliwość ominięcia problemu, gdy użytkownik cofnie uprawnienia.

Sprawdzone metody konserwacji

Podane poniżej sprawdzone metody dotyczą tworzenia aplikacji internetowych, które można konserwować, ale są szczególnie ważne podczas tworzenia dowolnych dodatków do Meet.

Używaj najnowszej wersji pakietu SDK Google Meet Add-ons

Pakiet SDK dodatków do Meet jest regularnie aktualizowany. Pakiet SDK przestrzega semantycznej numeracji wersji. Aby znaleźć najnowszą wersję:

  • W przypadku korzystania z gstatic: najnowsza wersja pakietu SDK znajduje się w adresie URL gstatic podanym w instrukcjach korzystania z pakietu SDK.
  • W przypadku korzystania z npm: uruchom npm update @googleworkspace/meet-add-ons z katalogu zawierającego package.json dla witryny, która hostuje Twoje rozszerzenie Meet.

Tworzenie projektu Google Cloud na potrzeby testów

Gdy dodatek 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 opróżnią pamięć podręczną lub gdy pamięć podręczna wygaśnie. Dlatego zalecamy, aby nie przesyłać zmian do wersji produkcyjnej, dopóki nie zostaną dokładnie przetestowane.

Aby uniknąć wdrażania bezpośrednio w środowisku produkcyjnym, zalecamy utworzenie osobnego projektu Google Cloud, który zostanie opublikowany prywatnie w organizacji. Ten projekt Cloud będzie hostować środowisko stagingowe i programistyczne Twojego dodatku do Meet. Dostęp do tego projektu w Google Cloud powinien być ograniczony do mniejszego zespołu, który bezpośrednio pracuje nad rozwojem Twojego dodatku.

Aby utworzyć te alternatywne środowiska dla dodatku, musisz najpierw hostować alternatywne środowiska swojej aplikacji internetowej, które zawierają dodatek, w domenie, której jesteś właścicielem. Następnie możesz utworzyć alternatywne środowiska dla dodatku Meet, dodając dodatkowe wdrożenia do projektu Google Cloud na etapie testowania. Te nowe wdrożenia powinny zawierać pliki manifestu, które wskazują alternatywne środowiska Twojej aplikacji internetowej. Następnie zalecamy zainstalowanie poszczególnych dodatków w ten sposób:

  • Testy: opublikuj wersję testową prywatnie, aby każdy w Twojej organizacji mógł pomóc w testowaniu.
  • Dla programistów: kliknij Zainstaluj w kolumnie Działania, aby zainstalować wersję deweloperską dodatku Meet tylko na swoim koncie.

Pisanie testów

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

  • Utworzenie wersji testowej pakietu SDK dodatków do Meet, a następnie sprawdzenie, czy dodatki do Meet wywołują funkcje pakietu SDK zgodnie z oczekiwaniami.
  • Testowanie jednostkowe wszystkich funkcji dodatku niezwiązanych z SDK przy użyciu preferowanej platformy do testowania stron internetowych.

Sprawdzone metody zapewniania wygody użytkowników

Poniższe sprawdzone metody pomagają zwiększyć intuicyjność i dopracowanie dodatku do Meet.

Zarządzanie stanem początkowym w panelu bocznym

Zdecydowanie zalecamy konfigurowanie dodatku na podstawie działań użytkownika podejmowanych w panelu bocznym. Aby to zrobić, ustaw stan początkowy aktywności w JavaScript. Wszystkie dane, które są przekazywane do ActivityStartingState, powinny być ustawiane przez inicjatora dodatku (zazwyczaj gospodarza spotkania) w panelu bocznym. Pierwsze okno panelu bocznego można traktować jako formularz służący do konfigurowania dodatku.

Zamknij panel boczny, gdy go nie używasz

Po rozpoczęciu aktywności przez wywołanie metody startActivity() nie zamykaj panelu bocznego tylko wtedy, gdy jest to istotny element dodatków do Google Meet. Po otwarciu ekranu głównego możesz zamknąć panel boczny, wywołując metodę unloadSidePanel().

Promowanie dodatku do Meet przez udostępnianie ekranu

Dodatki do Meet są ciekawsze 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ę zawierającą witrynę hostującą Twój dodatek Meet, można skonfigurować Meet tak, aby wszystkim uczestnikom rozmowy wyświetlany był baner 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 na potrzeby Meet postępuj zgodnie z tymi wskazówkami, aby logo wyglądało jak najlepiej teraz i w przyszłości:

Używaj formatu pliku PNG o rozmiarze 256 x 256 pikseli.

Używaj przejrzystości.

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

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

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