Reguły Apps Script powodują, że określona funkcja skryptu (funkcja reguły) jest wykonywana za każdym razem, gdy wystąpi określone zdarzenie. Wyzwalacze mogą być aktywowane tylko przez określone zdarzenia, a każda aplikacja Google Workspace obsługuje inny zestaw zdarzeń.
Gdy reguła zostanie uruchomiona, zostanie utworzony obiekt zdarzenia. Ta struktura JSON zawiera szczegółowe informacje o wydarzeniach. Informacje w strukturze obiektu zdarzenia są uporządkowane inaczej w zależności od typu reguły.
Po utworzeniu obiektu zdarzenia Apps Script przekazuje go jako parametr do funkcji trigger. Funkcja wyzwalająca to funkcja wywołania zwrotnego, którą musisz zaimplementować samodzielnie, aby podjąć odpowiednie działania w odpowiedzi na zdarzenie. Na przykład w dodatku Google Workspace, który rozszerza Gmaila, możesz zdefiniować regułę, która tworzy nowy interfejs karty, gdy użytkownik otworzy wątek wiadomości. W tym przypadku implementujesz funkcję wywołania zwrotnego w kontekście, aby utworzyć karty tworzące nowy interfejs użytkownika, korzystając z danych przekazanych w obiekcie zdarzenia.
Na tej stronie znajdziesz wskazówki dotyczące korzystania z wyzwalaczy w projektach dodatków Google Workspace.
Aktywatory pliku manifestu
W przeciwieństwie do dodatków do edytora dodatki Google Workspace obecnie nie mogą korzystać z prostych wyzwalaczy w Apps Script. Zamiast tego używają wyzwalaczy zaprojektowanych specjalnie dla dodatków Google Workspace: wyzwalaczy pliku manifestu.
Wyzwalacze w pliku manifestu są w całości definiowane w manifest dodatku Google Workspace. Przykłady wyzwalaczy w pliku manifestu:
- wyzwalacze strony głównej, które tworzą i wyświetlają stronę główną dodatku;
- Wydarzenia w kalendarzu – wyzwalacze otwarcia, które wyświetlają nową kartę lub wykonują inne działania po otwarciu wydarzenia w kalendarzu.
- Przyczyny aktualizacji wydarzenia w kalendarzu, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik zmodyfikuje i zapisze zdarzenie w kalendarzu.
- Dysk: zdarzenia wybrania elementów, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik wybierze co najmniej 1 plik lub folder na Dysku.
- Wyzwalacze tworzenia wiadomości w Gmailu, które wyświetlają kartę dodatku, gdy użytkownik otworzy dodatek w oknie tworzenia wiadomości w Gmailu.
- Przyciski kontekstowe Gmaila, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik otworzy wiadomość w Gmailu.
- Wyzwalacze Editor onFileScopeGranted, które wyświetlają nową kartę, gdy użytkownicy udzielają autoryzacji dla zakresu uprawnień OAuth
drive.filew bieżącym dokumencie w Edytorze.
Na powyższej liście tylko wyzwalacze strony głównej są niekontekstualne, pozostałe są wyzwalaczami kontekstowymi. Więcej informacji o definicjach reguł w pliku manifestu znajdziesz w artykule Plik manifestu.
Oprócz reguł w pliku manifestu dodatki Google Workspace mogą też używać instalowalnych reguł w Apps Script.
Ograniczenia
Korzystanie z tych wyzwalaczy jest obwarowane pewnymi ograniczeniami.
- Te wyzwalacze są używane tylko w projektach dodatków do Google Workspace. Nie mają zastosowania w żadnym innym przypadku.
- Ponieważ są one zdefiniowane w pliku manifestu dodatku, a nie w jego kodzie, nie możesz ich tworzyć ani modyfikować za pomocą usługi Apps Script
Script. - Reguły kontekstowe Gmaila mogą obecnie zawierać tylko kryterium
unconditional. Oznacza to, że reguły kontekstowe są uruchamiane w przypadku każdej wiadomości e-mail niezależnie od jej treści. - Każde rozszerzenie może mieć tylko jeden wyzwalacz każdego typu na użytkownika i dokument.