Wyzwalacze dla dodatków do Google Workspace

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 pliku manifestu 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.
  • Wyzwalacze aktualizacji zdarzeń w kalendarzu, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik zmodyfikuje i zapisze zdarzenie w kalendarzu.
  • Dysku na zdarzenia dotyczące wybranych 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.file w bieżącym dokumencie w Edytorze.

Na powyższej liście tylko wyzwalacze na stronie głównej są niekontekstualne, pozostałe są kontekstowe. 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.
  • Obecnie wyzwalacze kontekstowe Gmaila mogą zawierać tylko kryteria 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 1 wyzwalacz każdego typu na użytkownika i dokument.