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

 Otwórz stronę logowania usługi zewnętrznej 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. Użytkownik nadal może zobaczyć połączenie w Meet i do niego wrócić, a także wykonać mniej kliknięć.

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

Jeśli dodatkowy moduł Meet wywołuje interfejsy API Google, musisz przekazać pełną listę uprawnień OAuth wymaganych przez moduł. Można to zrobić na stronie Konfiguracja aplikacji Google Workspace Marketplace. Po dodaniu tych zakresów podczas instalowania dodatku do Meet użytkownicy zobaczą komunikat informujący, 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. Konfigurowanie ekranu zgody OAuth wymaga też ustawienia informacji o markowaniu, polityki prywatności i warunków korzystania z usługi, które są wyświetlane, gdy użytkownik prosi o dostęp do określonych zakresów. Aby opublikować treści publicznie, musisz przesłać te informacje do weryfikacji.

Podczas pisania kodu do wywoływania interfejsów API Google Workspace najłatwiej jest skorzystać z samouczka JavaScripta. 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

Poniższe 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 dodatków Google Meet

Pakiet SDK dodatków do Meet jest regularnie aktualizowany. Pakiet SDK przestrzega semantycznego numerowania 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 do Google Meet zostanie opublikowany w Google Workspace Marketplace, wszystkie nowe wdrożenia tego dodatku będą natychmiast dostępne dla użytkowników Google Meet. Użytkownicy zobaczą te aktualizacje, gdy opróżnią pamięć podręczną lub gdy jej okres ważności wygaśnie. Dlatego zalecamy, aby nie przesyłać zmian do witryny produkcyjnej, dopóki nie zostaną dokładnie przetestowane.

Aby uniknąć wdrożenia bezpośrednio w produkcji, zalecamy utworzenie osobnego projektu Google Cloud, który jest publikowany prywatnie w Twojej organizacji. Ten projekt Cloud będzie hostować środowisko stagingowe i środowisko 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 aplikacji internetowej. Następnie zalecamy zainstalowanie każdego środowiska dodatku w ten sposób:

  • Testy: 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 Meet w środowisku programistycznym zalecamy napisanie testów jednostkowych. Testy jednostkowe powinny obejmować:

  • Utworzenie symulatora 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, które nie są związane z pakietem SDK, za pomocą preferowanego frameworku do testowania stron internetowych;

Sprawdzone metody dotyczące wygody użytkowników

Te sprawdzone metody pomogą Ci uczynić dodatek do Meet bardziej intuicyjnym i dopracowanym.

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 trafiają do ActivityStartingState, powinny być ustawiane przez inicjatora dodatku (zazwyczaj gospodarza spotkania) w panelu bocznym. Pierwsze wyświetlenie panelu bocznego można traktować jako formularz służący do konfigurowania dodatku.

Zamknij panel boczny, gdy go nie używasz

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

Promowanie dodatku Meet za pomocą udostępniania ekranu

Dodatki do Meet zapewniają bogatsze 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ępnia kartę z witryną, która hostuje Twoje rozszerzenie Meet, Meet może wyświetlić baner wszystkim uczestnikom rozmowy, aby zachęcić ich do zainstalowania lub użycia odpowiedniego rozszerzenia 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.