Instalowanie i autoryzowanie dodatków

Użytkownicy muszą zainstalować i autoryzować dodatek, zanim będą mogli go otworzyć i z niego korzystać. Ponieważ to tylko pierwszy krok na wrażenia użytkowników, przed utworzeniem własnych dodatków.

Ta sekcja dokumentacji opisuje, jak użytkownicy mogą instalować, autoryzować i aby zacząć korzystać z dodatków.

Instalowanie dodatków

Aby móc używać dodatku, musisz go zainstalować. Po zainstalowaniu dodatek będzie dostępny w Google Workspace, aplikacja hostująca co się zmienia.

Opublikowane dodatki możesz zainstalować z poziomu aplikacji hosta Google Workspace lub ze sklepu Google Workspace Marketplace. Administratorzy domen mogą też instalować dodatki w imieniu użytkowników w Google Workspace Marketplace. Możesz też instalować niepublikowane dodatki, które opracowujesz, aby je przetestować. Zanim będzie można użyć zainstalowanej wersji musisz włączyć go po raz pierwszy, autoryzuj .

Więcej informacji: Publikowanie dodatków.

Autoryzacja dodatków

Po zainstalowaniu dodatku będzie on dostępny Google Workspace, aplikacja hostująca co się zmienia. Przy pierwszej próbie użycia funkcji i dodatek w aplikacji hosta wyświetla mu karty autoryzacji lub okna dialogowego. Na tej karcie znajdziesz informacje o dodatek wymaga uprawnień do wykonania w imieniu użytkownika, takich jak uzyskać dostęp do zawartości bieżącego arkusza Google. Użytkownik może przyznać te uprawnienia i zezwolić na działanie dodatku. Jeśli użytkownik odmówi udzielenia uprawnień dodatkowi, nie będzie mógł z niego korzystać.

Dodatki edytora korzystają z modelu autoryzacji, który różni się od modelu używanego przez dodatki Google Workspace. Dodatki do edytora działają na plikach na Dysku Google, dlatego model autoryzacji edytora definiuje różne tryby autoryzacji, które są wynikiem używania dodatków z poszczególnymi plikami. Podczas programowania dodatków do Edytora Google Ads, ważne jest, by rozumieć różne tryby działania, i przebiegu między nimi.

Autoryzowanie opublikowanych dodatków

Po zainstalowaniu opublikowanego dodatku od razu rozpocznie się proces autoryzacji:

  1. Pojawi się prośba o wybranie konta, na którym chcesz zainstalować dodatek.
  2. Zobaczysz listę autoryzacji dodatku. wymaga działania, więc wiadomo, do czego służy. Sprawdź dokładnie je wymienić. Jeśli nadal chcesz autoryzować, kliknij Zezwól. Dzięki temu będzie można korzystać z dodatku.
  3. Możesz go teraz uruchamiać aplikacja hostująca co się zmienia. Jeśli aplikacja była już otwarta w karcie przeglądarki, odśwież kartę, zanim dodatek zostanie udostępniony.

Jeśli zainstalowany dodatek zostanie później zaktualizowany i będzie wymagać dodatkowych uprawnień, których jeszcze nie masz, następnym razem, gdy go użyjesz, pojawi się prośba o te uprawnienia.

Autoryzowanie nieopublikowanych dodatków do Google Workspace

Karta autoryzacji dodatku

Nieopublikowane dodatki nie mają tego samego procesu autoryzacji co opublikowane dodatki. bo nie są jeszcze dostępne w Google Workspace Marketplace. Po instalując nieopublikowany dodatek, nie jest od razu prośba o autoryzację. Zamiast tego proces autoryzacji rozpoczyna się, gdy pierwszy raz spróbujesz go użyć.

Podczas uruchamiania dodatku określa on, czy potrzebna jest autoryzacja użytkownika. Jeśli jest wymagana, dodatek korzysta z karty autoryzacji. Autoryzacja jest zawsze wymagana przy pierwszym uruchomieniu dodatku, ale może też jest wymagane, jeśli nowa wersja dodatku korzysta z usługi, która nie była wcześniej . Przycisk Autoryzuj dostęp powoduje otwarcie okna dialogowego kliknij „Zezwalaj na autoryzację dodatku” lub „Odrzucaj jego autoryzację”.

Autoryzowanie usług innych niż Google w przypadku dodatku do Google Workspace

Dodatek Google Workspace może łączyć się z usługą innej firmy, która sama wymaga autoryzacji. Dodatki Google Workspace, które łączą się z takimi usługami, wymagają od użytkownika wykonania 2 oddzielnych działań:

  • Autoryzacja samego dodatku podczas jego instalowania lub po raz pierwszy rozpoczęto.
  • Autoryzacja usługi firmy innej niż Google przy pierwszym dostępie do niej.

Jeśli tworzony przez Ciebie dodatek Google Workspace musi mieć dostęp do usługi innej niż Google za pomocą OAuth, musisz skonfigurować połączenie z tą usługą podczas tworzenia dodatku.

Więcej informacji znajdziesz w artykule Łączenie dodatku do Google Workspace z usługą innej firmy.

Systemy do obsługi rozmów wideo innych firm

Dodatki Google Workspace, które rozszerzają funkcjonalność Kalendarza Google, mogą też dodawać dodatkowe rozwiązania do obsługi rozmów wideo, które umożliwiają użytkownikom wybór systemu do obsługi rozmów wideo innej firmy podczas edytowania wydarzeń w Kalendarzu Google. Jeśli Twój dodatek udostępnia opcje konferencji, które wymagają zalogowania się użytkownika, musisz umożliwić mu to.

Jeśli użytkownik spróbuje utworzyć konferencję za pomocą dodatku bez wymaganych informacji zaloguj się, czyli metoda onCreateFunction rozwiązania do konferencji powinien zwrócić błąd ConferenceData obiekt zawierający ConferenceError z adresu URL uwierzytelniania.

Po otrzymaniu tego obiektu Kalendarz Google tworzy w interfejsie edycji wydarzenia przycisk LOG IN, który prowadzi do podanego przez dodatek adresu URL uwierzytelniania. Użytkownicy mogą użyć tego przycisku, aby zalogować się w systemie zewnętrznym, zanim zaczną korzystać z dodatku.

Zobacz Tworzenie rozmów wideo innych firm , aby dowiedzieć się więcej na temat obsługi autoryzacji za pomocą tagu ConferenceError.

Autoryzuj nieopublikowane dodatki edytora

Sprawdzoną metodą jest testowanie dodatków do edytora w trakcie ich tworzenia. Proces autoryzacji jest identyczny jak w przypadku opublikowanych dodatków do edytora, z tym że rozpoczyna się on, gdy po raz pierwszy spróbujesz przetestować dodatek. Jeśli później sprawdzisz to samo nie pojawia się prośba o autoryzację.

Cofnij autoryzację dodatków

Podczas tworzenia dodatków warto cofnąć ich autoryzację, aby umożliwić ponowne przetestowanie proces autoryzacji.

Aby cofnąć autoryzację dodatku, wykonaj te czynności:

  1. Otwórz konsolę zabezpieczeń konta.
  2. Odszukaj i kliknij dodatek, którego autoryzację chcesz cofnąć.
  3. Kliknij Usuń dostęp.

Gdy ponownie uruchomisz dodatek po cofnięciu autoryzacji, proces autoryzacji zostanie przedstawiony ponownie.

Odinstalowywanie dodatków

Aby odinstalować dodatek zainstalowany z Google Workspace Marketplace, zapoznaj się z artykułem Odinstalowywanie aplikacji lub dodatku z Marketplace.

Odinstalowywanie wbudowanego, nieopublikowanego dodatku Apps Script znajdziesz w sekcji Odinstalowywanie nieopublikowanej książki .