Użytkownicy muszą zainstalować i autoryzować dodatek, zanim będą mogli go otworzyć i z niego korzystać. Ponieważ te czynności są pierwszym krokiem korzystania z dodatku dla użytkownika, musisz je poznać, zanim zaczniesz tworzyć własne dodatki.
Ta sekcja dokumentacji opisuje, jak użytkownicy mogą instalować i autoryzować dodatki, a także jak zacząć z nich korzystać.
Instalowanie dodatków
Aby móc używać dodatku, musisz go zainstalować. Po zainstalowaniu dodatek staje się dostępny w rozszerzanej aplikacji hosta Google Workspace.
Opublikowane dodatki możesz zainstalować z aplikacji hosta Google Workspace lub z Google Workspace Marketplace. Administratorzy domeny mogą też instalować dodatki w imieniu użytkowników z Google Workspace Marketplace. Możesz też instalować nieopublikowane dodatki, które tworzysz, aby je przetestować. Aby użyć zainstalowanego dodatku po raz pierwszy, musisz go autoryzować.
Więcej informacji znajdziesz w artykule Publikowanie dodatków.
Autoryzacja dodatków
Po zainstalowaniu dodatku staje się on dostępny w rozszerzanej aplikacji hosta Google Workspace. Gdy użytkownik po raz pierwszy spróbuje użyć dodatku w aplikacji hosta, wyświetli mu się karta autoryzacji lub okno dialogowe. Na tej karcie dowiesz się, co dodatek potrzebuje uprawnień do wykonywania działań użytkownika (np. do uzyskiwania dostępu do zawartości bieżącego Arkusza Google). Użytkownik może następnie przyznać te uprawnienia i zezwolić na używanie dodatku. Jeśli użytkownik odmówi przyznania dodatku, nie będzie mógł go używać.
Dodatki do Edytora używają modelu autoryzacji innego niż dodatki do Google Workspace. Dodatki do edytorów działają na plikach na Dysku Google, dlatego model autoryzacji edytora definiuje różne tryby autoryzacji, które działają, gdy dodatki są używane z poszczególnymi plikami. Przy tworzeniu dodatków do edytora ważne jest, aby znać różne tryby działania i sposób ich przenoszenia.
Autoryzuj opublikowane dodatki
Po zainstalowaniu opublikowanego dodatku proces autoryzacji rozpocznie się natychmiast:
- Pojawi się prośba o wybranie konta, na którym chcesz zainstalować dodatek.
- Zobaczysz listę autoryzacji, których dodatek wymaga do działania, dzięki czemu dokładnie wiesz, do czego służy. Uważnie przejrzyj tę listę i jeśli nadal chcesz przyznawać uprawnienia, kliknij Zezwól. Spowoduje to włączenie dodatku.
- Możesz go teraz uruchomić z rozszerzonej aplikacji hosta. Jeśli aplikacja była już otwarta na karcie przeglądarki, konieczne może być odświeżenie tej karty, zanim dodatek będzie dostępny.
Jeśli zainstalowany dodatek zostanie później zaktualizowany i będzie wymagać dodatkowych autoryzacji, które nie zostały jeszcze przez Ciebie przyznane, zobaczysz prośbę o przyznanie tych uprawnień przy następnym użyciu tego dodatku.
Autoryzuj nieopublikowane dodatki do Google Workspace
Nieopublikowane dodatki nie mają takiego samego procesu autoryzacji jak te opublikowane, ponieważ nie są jeszcze dostępne w Google Workspace Marketplace. Po zainstalowaniu nieopublikowanego dodatku nie zobaczysz od razu prośby o autoryzację. Zamiast tego proces autoryzacji rozpoczyna się przy pierwszej próbie użycia dodatku.
Dodatek określa, czy wymagana jest autoryzacja użytkownika. Jeśli autoryzacja jest wymagana, dodatek wyświetla kartę autoryzacji. Autoryzacja jest wymagana przy pierwszym uruchomieniu dodatku i może też być wymagana, jeśli nowa wersja dodatku używa usługi, która nie została wcześniej autoryzowana. Przycisk Autoryzuj dostęp powoduje otwarcie okna dialogowego, w którym użytkownik może zezwolić na używanie dodatku lub go odrzucić.
Autoryzowanie usług innych niż Google w dodatku do Google Workspace
Dodatek do Google Workspace może łączyć się z usługą innej firmy, która wymaga autoryzacji. Dodatki do Google Workspace, które łączą się z takimi usługami, wymagają od użytkownika 2 osobnych działań:
- Autoryzacja samego dodatku podczas jego instalowania lub uruchamiania.
- Autoryzacja usługi niepochodzącej od Google przy pierwszym dostępie do niej.
Jeśli rozwijany dodatek do Google Workspace musi mieć dostęp do usługi innej niż Google za pomocą protokołu OAuth, podczas tworzenia dodatku musisz skonfigurować połączenie z tą usługą.
Więcej informacji znajdziesz w artykule Łączenie dodatku Google Workspace z usługą innej firmy.
Systemy do obsługi rozmów wideo innych firm
Dodatki do Google Workspace, które rozszerzają możliwości Kalendarza Google, mogą też dodać więcej rozwiązań do obsługi rozmów wideo, które umożliwiają użytkownikom wybranie systemu do obsługi rozmów wideo innej firmy podczas edytowania wydarzeń w Kalendarzu Google. Jeśli Twój dodatek udostępnia opcje rozmów wideo, które wymagają od użytkownika zalogowania się, musi on dawać użytkownikowi taką możliwość.
Jeśli użytkownik spróbuje utworzyć konferencję za pomocą dodatku bez logowania się, metoda onCreateFunction rozwiązań do rozmów wideo powinna zwrócić obiekt ConferenceData zawierający ConferenceError z adresem URL uwierzytelniania.
Po otrzymaniu tego obiektu Kalendarz Google tworzy w interfejsie edycji wydarzeń przycisk ZALOGUJ SIĘ, który prowadzi do adresu URL uwierzytelniania dostarczanego przez dodatek. Użytkownicy mogą użyć tego przycisku, aby zalogować się w systemie innej firmy, zanim zaczną używać dodatku.
Więcej informacji o obsłudze autoryzacji za pomocą ConferenceError znajdziesz w artykule Tworzenie rozmów wideo z innymi firmami.
Autoryzuj nieopublikowane dodatki edytora
Sprawdzoną metodą jest testowanie dodatków do Edytora. Proces autoryzacji jest taki sam jak w przypadku opublikowanych dodatków do Edytora, z wyjątkiem tego, że rozpoczyna się przy pierwszej próbie przetestowania dodatku. Jeśli później sprawdzisz ten sam dodatek, nie pojawi się prośba o autoryzację.
Cofnij autoryzację dodatków
Podczas tworzenia dodatków warto cofnąć ich autoryzację, aby można było ponownie przetestować proces autoryzacji.
Aby cofnąć autoryzację dodatku, wykonaj te czynności:
- Otwórz konsolę zabezpieczeń konta.
- Znajdź i kliknij dodatek, którego autoryzację chcesz cofnąć.
- Kliknij Usuń dostęp.
Gdy uruchomisz dodatek ponownie po cofnięciu autoryzacji, proces autoryzacji pokaże się ponownie.
Powiązane artykuły
- Otwieranie i używanie zainstalowanych dodatków
- Łączenie dodatku Google Workspace z usługą innej firmy