Wyzwalacze dodatków do Google Workspace

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

Wyzwalacze Apps Script powodują wykonywanie określonej funkcji skryptu (funkcji aktywatora), gdy wystąpi określone zdarzenie. Tylko określone zdarzenia mogą wywoływać reguły, 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 tym zdarzeniu. Informacje w strukturze obiektów zdarzeń są uporządkowane inaczej 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 odpowiadające na żądanie. Na przykład w dodatku do 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 implementujesz kontekstową funkcję wywołania zwrotnego, aby tworzyć karty składające się na nowy interfejs użytkownika na podstawie danych przekazywanych w obiekcie zdarzenia.

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

Aktywatory pliku manifestu

W odróżnieniu od dodatków do edytorów dodatki do Google Workspace nie mogą obecnie używać prostych reguł Apps Script. Zamiast nich korzystają z aktywatorów zaprojektowanych specjalnie dla dodatków do Google Workspace: aktywatorów plików manifestu.

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

  • Wyzwalacz na stronie głównej, który kompiluje i wyświetla stronę główną dodatku.
  • Wyzwalacze EventEvent, które wyświetlają nową kartę lub wykonują inne działania po otwarciu wydarzenia w Kalendarzu.
  • Wyzwalacze EventUpdate, które wyświetlają nową kartę lub wykonują inne działania, gdy użytkownik edytuje i zapisuje wydarzenie w Kalendarzu.
  • Aktywator onDrivesSelected, który wyświetla nową kartę lub wykonuje inne działania, gdy użytkownik wybierze co najmniej jeden 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.
  • Wyzwalacz edytora onFileScopeGranted, który wyświetla nową kartę, gdy użytkownik udzieli autoryzacji dla zakresu OAuth drive.file w bieżącym dokumencie edytora.

Na liście powyżej tylko reguły na stronie głównej nie są związane z kontekstem, a pozostałe – reguły kontekstowe. Więcej informacji o definicjach aktywatorów manifestu znajdziesz w artykule Plik manifestu.

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

Ograniczenia

Aktywatory plików manifestu mają pewne ograniczenia.

  • Te aktywatory są używane tylko w projektach dodatków do Google Workspace. Nie mają one zastosowania w żadnej innej aplikacji.
  • Zdefiniowano je w pliku manifestu dodatku, a nie w kodzie, więc nie możesz tworzyć ani modyfikować tych aktywatorów 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.