Wyzwalacze dotyczące dodatków do Google Workspace

Wyzwalacze Apps Script powodują wykonanie określonej funkcji skryptu (funkcji aktywatora) po wystąpieniu określonego zdarzenia. Tylko niektóre zdarzenia mogą powodować uruchamianie aktywatorów, a każda aplikacja Google Workspace obsługuje inny zestaw zdarzeń.

Uruchomienie reguły powoduje utworzenie obiektu zdarzenia. Ta struktura JSON zawiera szczegółowe informacje o wystąpieniu zdarzenia. Informacje w strukturze obiektu zdarzenia są uporządkowane w różny sposób w zależności od typu aktywatora.

Po utworzeniu obiektu zdarzenia Apps Script przekazuje go jako parametr do funkcji aktywatora. Funkcja aktywująca to funkcja wywołania zwrotnego, którą musisz zaimplementować samodzielnie, aby wykonywać działania potrzebne do odpowiedzi na zdarzenie. Na przykład w dodatku do Google Workspace, który rozszerza Gmaila, możesz zdefiniować aktywator, który tworzy interfejs nowej karty, gdy użytkownik otworzy wątek wiadomości. W takim przypadku implementujesz funkcję kontekstowego wywołania zwrotnego, aby utworzyć karty tworzące nowy interfejs użytkownika przy użyciu danych przekazywanych w obiekcie zdarzenia.

Ta strona zawiera wskazówki dotyczące używania aktywatorów w projektach dodatków Google Workspace.

Aktywatory pliku manifestu

W przeciwieństwie do dodatków do edytora dodatki do Google Workspace nie mogą obecnie używać prostych aktywatorów Apps Script. Zamiast tego korzystają z reguł pliku manifestu przeznaczonych specjalnie dla dodatków do Google Workspace.

Aktywatory pliku manifestu są w całości zdefiniowane w pliku manifestu dodatku Google Workspace. Przykłady aktywatorów pliku manifestu:

  • Reguły dotyczące strony głównej, które tworzą i wyświetlają stronę główną dodatku.
  • aktywatory otwierania wydarzeń w Kalendarzu, które po otwarciu wydarzenia w Kalendarzu wyświetlają nową kartę lub wykonują inne działania.
  • Wyzwalacze aktualizacji wydarzenia w Kalendarzu, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik edytuje i zapisuje wydarzenie w Kalendarzu.
  • reguły Dysku onItemsSelected, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik wybierze co najmniej jeden plik lub folder na Dysku;
  • Wyzwalacze tworzenia wiadomości w Gmailu, które wyświetlają kartę dodatku, gdy użytkownik otworzy ten dodatek w oknie tworzenia wiadomości w Gmailu.
  • Wyzwalacze kontekstowe Gmaila, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik otworzy wiadomość w Gmailu.
  • Aktywatory edytora onFileScopeGranted, które wyświetlają nową kartę, gdy użytkownicy przyznają autoryzację dla zakresu OAuth drive.file w bieżącym dokumencie edytora.

Na powyższej liście tylko reguły powiązane ze stroną główną nie są kontekstowe, a pozostałe to reguły kontekstowe. Więcej informacji o definicjach aktywatorów w pliku manifestu znajdziesz w pliku manifestu.

Oprócz aktywatorów w pliku manifestu dodatki do Google Workspace mogą też korzystać z reguł instalowanych Apps Script.

Ograniczenia

Korzystanie z reguł w pliku manifestu podlega pewnym ograniczeniom.

  • Te aktywatory są używane tylko w projektach dodatków do Google Workspace – nie mają celu w żadnej innej aplikacji.
  • Ponieważ są one zdefiniowane w pliku manifestu dodatku, a nie w jego kodzie, nie możesz użyć usługi Apps Script Script do tworzenia ani modyfikowania tych aktywatorów.
  • Obecnie reguły kontekstowe Gmaila mogą mieć tylko kryteria typu unconditional. Oznacza to, że reguły kontekstowe są wywoływane w przypadku każdego e-maila niezależnie od jego treści.
  • Każdy dodatek może mieć tylko 1 regułę danego typu na użytkownika w danym dokumencie.