Sprawdzone metody

Ulepszaj ogólne wrażenia, postępując zgodnie z instrukcjami Projekt dodatku Google Meet.

Sprawdzone metody autoryzacji

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

Użyj Logowania przez Google

Wielu użytkowników dodatków do Google Workspace już wcześniej zalogowało się w Google dołącza do spotkania. Dlatego jeśli musisz mieć Logowanie przez Google, może zapisać się kilka kliknięć, gdy użytkownik proces logowania.

Otwórz stronę logowania przez usługę zewnętrzną w nowym oknie

Oprócz logowania przez Google aplikacja może oferować dodatkowe logowanie i zbierania danych. Jeśli tak, użyj okna dialogowego, zamiast otwierać stronę logowania w nowa karta. Dzięki temu użytkownik może wyświetlić witrynę i wrócić do niej połączenie w Meet i uzyska mniejszą ogólną liczbę kliknięć.

Prawidłowe żądania zakresów do interfejsów API Google

Jeśli dodatek do Meet wywołuje interfejsy API Google, musisz podać pełną listę protokołu OAuth zakresy wymagane przez dodatek. Odbywa się to w Strona konfiguracji aplikacji z Google Workspace Marketplace. Po dodaniu zakresów, użytkownicy zobaczą prośbę podczas instalacji Dodatek do Meet, który informuje użytkowników, jakiego rodzaju dane są co umożliwia aplikacji dostęp.

Zanim opublikujesz dodatek, musisz też skonfigurować zgodę OAuth ekranu. Wymaga to dodania dokładnie tych samych zakresów autoryzacji z Konfiguracja aplikacji z Google Workspace Marketplace. Konfigurowanie protokołu OAuth a także określić informacje o marce, politykę prywatności i warunki korzystania z usługi, które są wyświetlane po wysłaniu żądania zakresów. Do opublikowania wszystkie te informacje należy przesłać do weryfikacji.

Podczas pisania kodu wywołującego interfejsy Google Workspace API za pomocą instrukcji JavaScript Krótkie wprowadzenie jest najłatwiejszy. Takie podejście jest zgodne ze sprawdzonymi metodami dotyczącymi za pomocą Logowania przez Google i okien dialogowych. Pamiętaj, że inicjowanie tokena w JavaScript wymaga osobnego żądania zakresów, które aplikacja jest używany w czasie działania. Aby zapewnić użytkownikom najlepsze wrażenia, te żądane zakresy powinny odpowiadać ustawieniom w konfiguracji aplikacji z Google Workspace Marketplace stronę. Taka nadmiarowość to rozwiązanie zastępcze na potrzeby obsługi przypadku, w którym odwołano użytkownik .

Sprawdzone metody konserwacji

Te sprawdzone metody dotyczą pisania łatwego do utrzymywania aplikacji internetowych, ale są szczególnie ważne przy tworzeniu Dodatki do Meet.

Użyj najnowszej wersji pakietu SDK dodatków do Google Meet

Pakiet SDK dodatków do Meet jest regularnie aktualizowany. Pakiet SDK jest zgodny z obsługę wersji semantycznych. Aby znaleźć najnowszą wersję:

  • Jeśli używasz pakietu gstatic: najnowsza wersja pakietu SDK jest zawarta w pliku gstatic Adres URL podany w instrukcjach korzystania z pakietu SDK.
  • Jeśli używasz npm: uruchom npm update @googleworkspace/meet-add-ons z wewnątrz katalogu zawierającym package.json w witrynie, w której jest hostowany dodatek do Meet.

Tworzenie przejściowych projektów Google Cloud

Po opublikowaniu dodatku do Google Meet w Google Workspace Marketplace, wszystkie nowe wdrożenia dodatku Google Meet są od razu dostępne dostępnych dla użytkowników Meet. Użytkownicy zobaczą te aktualizacje, gdy tylko jeśli pamięć podręczna zostanie opróżniona, albo pamięć podręczna wygaśnie. Dlatego nie zalecamy wprowadzanie zmian w witrynie produkcyjnej do czasu dokładnego przetestowania ich.

Aby uniknąć wdrażania bezpośrednio w środowisku produkcyjnym, zalecamy utworzenie oddzielnego projekt Google Cloud, który jest opublikowany prywatnie; Twojej organizacji. Ten projekt Cloud będzie hostować środowisko testowe środowiska programistycznego dodatku do Meet. Dostęp w tym projekcie Cloud należy ograniczyć do mniejszego zespołu, bezpośrednio pracować nad Twoim dodatkiem.

Aby utworzyć te środowiska alternatywne dla dodatku: musisz najpierw hostować alternatywne środowiska aplikacji internetowej, zawiera Twój dodatek w domenie, której jesteś właścicielem. Następnie: możesz utworzyć alternatywne środowiska dla Dodatek do Meet przez dodanie kolejnego wdrożenia w przejściowym projekcie Google Cloud. Te nowe wdrożenia powinny mieć plików manifestu, które wskazują alternatywne środowiska aplikacji internetowej. Następnie zalecamy zainstalowanie każdego dodatku. w następujący sposób:

  • Przejściowa: publikowanie wersji przejściowej prywatnie aby każda osoba w organizacji mogła pomóc w testowaniu.
  • Dla programistów: kliknij Zainstaluj w kolumnie Działania, by zainstalować Poznaj wersję deweloperską dodatku tylko na Twoim koncie.

Pisanie testów

Zanim wdrożysz dodatek Meet w środowisku programistycznym zalecamy pisanie testów jednostkowych. Twoje testy jednostkowe powinny obejmować:

  • Wypróbuj pakiet SDK dodatków do Meet, a następnie sprawdź, czy Dodatek do Meet wywołuje funkcje pakietu SDK zgodnie z oczekiwaniami.
  • Testowanie jednostkowe wszystkich funkcji niezwiązanych z pakietem SDK za pomocą wybranego środowiska do testowania stron internetowych.

Sprawdzone metody zapewniania wygody użytkownikom

Podane niżej sprawdzone metody pomogą Ci utworzyć dodatek do Meet bardziej intuicyjny i dopracowany.

Zarządzaj stanem początkowym w panelu bocznym

Zdecydowanie zalecamy skonfigurowanie dodatku na podstawie działań użytkownika w panelu bocznym. W tym celu należy ustawić początek współpracy stan w JavaScriptu. Wszystkie dane trafiające do CollaborationStartingState powinna być ustawiana przez osobę, która zainicjowała dodatek (zwykle gospodarz spotkania) w panelu bocznym. Pierwszy widok panel boczny jako formularz do sterowania konfiguracją Google Analytics.

Zamykaj panel boczny, gdy nie jest używany

Po rozpoczęciu aktywności za pomocą połączenia startCollaboration, powinieneś zachować tylko panel boczny otworzyć, jeśli jest to kluczowy element wrażeń użytkownika Dodatek do Google Meet. Panel boczny można zamknąć, gdy główny etap jest otwarty przez wywołanie unloadSidePanel.

Promuj dodatek do Meet przez udostępnianie ekranu

Dodatki do Meet są ciekawsze niż udostępnianie ekranu. Jednak wielu użytkowników jest przyzwyczajonych do udostępniania ekranu w Meet. funkcji. Jeśli użytkownik udostępni kartę, na której znajduje się witryna, Dodatek do Meet, który można skonfigurować tak, wyświetlić baner dla wszystkich uczestników rozmowy i zachęcić ich do zainstalowania odpowiedniego dodatku do Meet. Więcej informacji: Promowanie dodatku na ekranie udostępnianie.