Wyzwalacze dodatków do Google Workspace

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Aktywatory Apps Script powodują wykonanie określonej funkcji skryptu (funkcji wyzwalacza), gdy wystąpi określone zdarzenie. Tylko niektóre zdarzenia mogą powodować uruchamianie reguł, a każda aplikacja Google Workspace obsługuje inny zestaw zdarzeń.

Po uruchomieniu reguły tworzony jest obiekt zdarzenia. Ta struktura JSON zawiera szczegółowe informacje o zdarzeniu. Informacje w strukturze obiektów zdarzeń są uporządkowane w zależności od typu aktywatora.

Po utworzeniu obiektu zdarzenia Apps Script przekazuje go jako parametr do funkcji aktywatora. Funkcja aktywatora to funkcja wywołania zwrotnego, którą musisz zaimplementować samodzielnie, aby podjąć działania odpowiednie do wywołania zdarzenia. Na przykład w dodatku Google Workspace, który rozszerza Gmaila, możesz zdefiniować regułę, która tworzy nowy interfejs karty po otwarciu przez użytkownika wątku wiadomości. W tym przypadku wdrażasz funkcję kontekstowego wywołania zwrotnego, aby utworzyć karty tworzące nowy interfejs użytkownika na podstawie danych przekazanych w obiekcie zdarzenia.

Na tej stronie znajdziesz wskazówki dotyczące używania aktywatorów w projektach dodatków Google Workspace.

Aktywatory pliku manifestu

W przeciwieństwie do dodatków do edycji dodatki do Google Workspace nie mogą obecnie używać prostych reguł Apps Script. Zamiast nich korzystają z reguł zaprojektowanych specjalnie dla dodatków do Google Workspace: reguły manifestu.

Aktywatory pliku manifestu są w pełni zdefiniowane w pliku manifestu dodatku Google Workspace. Przykłady reguł manifestu:

  • Reguły na stronie głównej, które tworzą i wyświetlają stronę główną dodatku.
  • Wyzwalacze wydarzeń w Kalendarzu, które wyświetlają nową kartę lub wykonują inne działania po otwarciu wydarzenia w Kalendarzu.
  • Wyzwalacz wydarzenia w Kalendarzu, który powoduje wyświetlenie nowej karty lub wykonanie innych czynności, gdy użytkownik edytuje i zapisuje wydarzenie w Kalendarzu.
  • Aktywator onItemsSelected, który wyświetla nową kartę lub wykonuje inne działania, 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 otworzy dodatek w oknie tworzenia wiadomości w Gmailu.
  • Reguły kontekstowe Gmaila, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik otworzy wiadomość w Gmailu
  • Wyzwalacze „onEditScopeGranted” wyświetlające nową kartę, gdy użytkownicy przyznają autoryzację dla zakresu OAuth drive.file w bieżącym dokumencie edytora.

Na liście powyżej tylko aktywatory strony głównej nie są kontekstowe, a pozostałe są kontekstowe. Więcej informacji o definicjach reguł manifestu znajdziesz w pliku manifestu.

Oprócz aktywatorów pliku manifestu dodatki Google Workspace mogą też używać instalacyjnych reguł Apps Script.

Ograniczenia

Aktywatory pliku manifestu mają określone ograniczenia.

  • Te reguły są używane tylko w projektach dodatków do Google Workspace. Nie mają zastosowania w żadnych innych aplikacjach.
  • Ponieważ są one zdefiniowane w pliku manifestu dodatku, a nie w kodzie, nie możesz utworzyć ani zmienić tych reguł za pomocą usługi Apps Script Script.
  • Reguły kontekstowe Gmaila mogą obecnie mieć tylko kryteria unconditional. Oznacza to, że reguły kontekstowe uruchamiają się dla każdej wiadomości e-mail niezależnie od jej treści.