Wyzwalacze dodatków do Google Workspace

Wyzwalacze Apps Script powodują wystąpienie określonego skryptu funkcja (funkcja wyzwalacza), która ma być wykonywana za każdym razem, gdy określone zdarzenie ma miejsce. Tylko niektóre zdarzenia mogą powodować uruchamianie reguł. Aplikacja Google Workspace obsługuje inny zestaw zdarzeń.

Po uruchomieniu reguły tworzony jest obiekt zdarzenia. Ta struktura JSON zawiera szczegółowe informacje o wystąpieniu zdarzenia. Informacje zawarte w zdarzeniu czy struktura obiektu jest różna w zależności od typu reguły.

Po utworzeniu obiektu zdarzenia Apps Script przekazuje go jako parametr do . Funkcja aktywatora to funkcja wywołania zwrotnego, wdrożenia i działań, które pozwolą zareagować . Na przykład w parametrze dodatku Google Workspace, który rozszerza Gmaila. zdefiniuj regułę, która utworzy nowy interfejs karty, gdy użytkownik otworzy wiadomość w wątku. W tym przypadku implementujesz kontekstową funkcję wywołania zwrotnego, by utworzyć kart tworzących nowy interfejs użytkownika, które korzystają z danych event.

Na tej stronie znajdziesz wytyczne dotyczące używania reguł w Google Workspace, projektów dodatkowych.

Aktywatory pliku manifestu

W przeciwieństwie do dodatków do Edytora Google Workspace dodatki do Google Workspace obecnie nie można używać prostych wyzwalaczy Apps Script Zamiast tego korzystają z aktywatorów zaprojektowanych specjalnie pod kątem Dodatki do Google Workspace: reguły manifestu.

Aktywatory pliku manifestu są w pełni zdefiniowane w sekcji Dodatek do Google Workspace manifest. Przykładami aktywatorów w pliku manifestu są: :

• Aktywatory strony głównej, które tworzą i wyświetlają stronę główną dodatku.
• Reguły eventOpen, które wyświetlają nową kartę lub podjęcie działania innych czynności po otwarciu wydarzenia w Kalendarzu.
• Wyzwalacze aktualizacji wydarzenia w kalendarzu, które wyświetlają nową kartę lub podjęcie działania inne działania, które użytkownik zmodyfikuje i zapisze wydarzenie w Kalendarzu.
• Wyzwalacze związane z Dysku onItemsSelected, które powodują wyświetlenie nowej karty lub podjęcia innych działań, gdy użytkownik wybierze co najmniej 1 plik lub folder na Dysku.
• Reguły tworzenia wiadomości w Gmailu, które wyświetlają kartę dodatku, gdy użytkownik otwiera dodatek w oknie tworzenia wiadomości w Gmailu.
• Reguły kontekstowe w Gmailu, które wyświetlają nową kartę lub inne czynności wykonywane, gdy użytkownik otworzy wiadomość w Gmailu.
• reguły edytora onFileScopeGranted, które wyświetlają nową kartę, gdy użytkownicy przyznaj autoryzację dla zakresu OAuth drive.file w bieżącym edytorze dokument.

Na liście powyżej tylko reguły związane ze stroną główną nie są kontekstowe. reszta to za pomocą czynników kontekstowych. Zobacz plik manifestu .

Oprócz aktywatorów manifestu, Google Workspace dodatki mogą również używać Apps Script reguły instalacyjne.

Ograniczenia

Używanie aktywatorów pliku manifestu podlega pewnym ograniczeniom.

• Te aktywatory są używane tylko w projektach dodatków do Google Workspace. nie mają żadnego celu w żadnej innej aplikacji.
• Ponieważ są one zdefiniowane w pliku manifestu dodatku, a nie w jego kodzie, nie możesz używasz Apps Script Script. w celu utworzenia lub zmodyfikowania tych aktywatorów.
• Reguły kontekstowe Gmaila mogą obecnie mieć tylko kryteria unconditional. Oznacza to, że reguły kontekstowe uruchamiają się w przypadku każdej wiadomości e-mail, niezależnie od tego treści.
• Każdy dodatek może mieć tylko 1 wyzwalacz danego typu na użytkownika na dokument.