Obiekty zdarzeń

Proste aktywatory i aktywatory z możliwością zainstalowania umożliwiają automatyczne uruchamianie funkcji w przypadku wystąpienia określonego zdarzenia. Gdy zostanie uruchomiony jakiś element, Apps Script przekazuje funkcji obiekt zdarzenia jako argument, zwykle o nazwie e. Obiekt zdarzenia zawiera informacje o kontekście, który spowodował uruchomienie reguły. Na przykład poniższy przykładowy kod pokazuje prosty onEdit(e)wyzwalacz dla skryptu Google Sheets, który używa obiektu zdarzenia do określenia, która komórka została zmodyfikowana.

function onEdit(e){
  // Set a comment on the edited cell to indicate when it was changed.
  var range = e.range;
  range.setNote('Last modified: ' + new Date());
}

Na tej stronie znajdziesz szczegółowe informacje o polach obiektu zdarzenia w przypadku różnych typów reguł.

Zdarzenia generowane przez aktywatory z możliwością zainstalowania zawierają identyfikator triggerUid, który wskazuje aktywator, który wygenerował zdarzenie. Jest to przydatne w przypadku skryptów, które mają wiele instalowanych reguł.

zdarzenia w Arkuszach Google.

Różne reguły związane z Arkuszami Google umożliwiają skryptom reagowanie na działania użytkownika w arkuszu kalkulacyjnym.

Otwórz (proste i możliwe do zainstalowania)
authMode	Wartość z typu enum ScriptApp.AuthMode. LIMITED
source	Obiekt Spreadsheet reprezentujący plik Arkuszy Google, do którego jest powiązany skrypt. Spreadsheet
triggerUid	Identyfikator reguły, która spowodowała to zdarzenie (tylko reguły instalowane). 4034124084959907503
user	Obiekt User, reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń zabezpieczeń). [e-mail]

Zmień (możliwość zainstalowania)
authMode	Wartość z typu enum ScriptApp.AuthMode. FULL
changeType	typ zmiany (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW, REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT lub OTHER); INSERT_ROW
source	Obiekt Spreadsheet reprezentujący plik Arkuszy Google, do którego jest powiązany skrypt. Spreadsheet
triggerUid	Identyfikator reguły, która wywołała to zdarzenie. 4034124084959907503
user	Obiekt User, reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń zabezpieczeń). [e-mail]

Edytuj (proste i możliwe do zainstalowania)
authMode	Wartość z typu enum ScriptApp.AuthMode. LIMITED
oldValue	Wartość komórki przed zmianą (jeśli była). Dostępna tylko wtedy, gdy edytowany zakres to pojedyncza komórka. Będzie nieokreślony, jeśli komórka nie miała wcześniej treści. 1234
range	Obiekt Range reprezentujący komórkę lub zakres komórek, które zostały edytowane. Range
source	Obiekt Spreadsheet reprezentujący plik Arkuszy Google, do którego jest powiązany skrypt. Spreadsheet
triggerUid	Identyfikator reguły, która spowodowała to zdarzenie (tylko reguły instalowane). 4034124084959907503
user	Obiekt User, reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń zabezpieczeń). [e-mail]
value	Nowa wartość komórki po zmianie. Ta opcja jest dostępna tylko wtedy, gdy edytowany zakres to pojedyncza komórka. 10

Przesłanie formularza (można zainstalować)
Uwaga: pamiętaj, aby używać tej reguły przesyłania formularza z SpreadsheetTriggerBuilder.
authMode	Wartość z typu enum ScriptApp.AuthMode. FULL
namedValues	Obiekt zawierający nazwy i wartości pytań z przesłanego formularza. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] }
range	Obiekt Range reprezentujący komórkę lub zakres komórek, które zostały edytowane. Range
triggerUid	Identyfikator reguły, która wywołała to zdarzenie. 4034124084959907503
values	Tablica z wartościami w takiej samej kolejności, w jakiej występują w arkuszu kalkulacyjnym. ['2015/05/04 15:00', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

Zdarzenia Dokumentów Google

Reguły umożliwiają Dokumentom Google reagowanie, gdy użytkownik otworzy dokument.

Otwórz (proste i możliwe do zainstalowania)
authMode	Wartość z typu enum ScriptApp.AuthMode. LIMITED
source	Obiekt Document reprezentujący plik Dokumentów Google, do którego jest powiązany skrypt. Document
triggerUid	Identyfikator reguły, która spowodowała to zdarzenie (tylko reguły instalowane). 4034124084959907503
user	Obiekt User, reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń zabezpieczeń). [e-mail]

Zdarzenia w Prezentacjach Google

Wyzwalacze umożliwiają Prezentacjom Google reagowanie, gdy użytkownik otworzy prezentację.

Otwórz (proste)
authMode	Wartość z typu enum ScriptApp.AuthMode. LIMITED
source	Obiekt Presentation reprezentujący plik Prezentacji Google, do którego jest powiązany skrypt. Presentation
user	Obiekt User, reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń zabezpieczeń). [e-mail]

zdarzenia w Formularzach Google,

Dzięki wyzwalaczom dotyczącym formularzy Google skrypty mogą reagować, gdy użytkownik edytuje formularz lub przesyła odpowiedź.

Otwórz * (proste i możliwe do zainstalowania)
authMode	Wartość z typu enum ScriptApp.AuthMode. LIMITED
source	Obiekt Form reprezentujący plik Formularzy Google, do którego jest powiązany skrypt. Form
triggerUid	Identyfikator reguły, która spowodowała to zdarzenie (tylko reguły instalowane). 4034124084959907503
user	Obiekt User, który reprezentuje aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń zabezpieczeń). [e-mail]

* To zdarzenie nie występuje, gdy użytkownik otwiera formularz, aby go wypełnić, ale gdy edytor otwiera formularz, aby go zmodyfikować.

Przesłanie formularza (można zainstalować)
Uwaga: pamiętaj, aby używać tej reguły przesyłania formularza z FormTriggerBuilder.
authMode	Wartość z typu enum ScriptApp.AuthMode. FULL
response	Obiekt FormResponse, który reprezentuje odpowiedź użytkownika na formularz jako całość. FormResponse
source	Obiekt Form reprezentujący plik Formularzy Google, do którego jest powiązany skrypt. Form
triggerUid	Identyfikator reguły, która wywołała to zdarzenie. 4034124084959907503

wydarzeniach w Kalendarzu Google;

Kalendarz uruchamia akcje, gdy wydarzenia w kalendarzu użytkownika są aktualizowane (tworzone, edytowane lub usuwane).

Te reguły nie podają, które zdarzenie się zmieniło ani jak się zmieniło. Zamiast tego wskazują, że Twój kod musi wykonać przyrostową synchronizację, aby uwzględnić ostatnie zmiany w kalendarzu. Pełny opis tej procedury znajdziesz w przewodniku po synchronizowaniu zasobów dotyczącym interfejsu Calendar API.

Aby zsynchronizować z Kalendarzem w Apps Script, wykonaj te czynności:

1. Włącz usługę zaawansowaną Kalendarz w projekcie skryptu. Wbudowana usługa Kalendarz nie wystarcza do tego procesu.
2. Określ, które kalendarze mają być synchronizowane. W przypadku każdego takiego kalendarza wykonaj operację pierwszego synchronizowania za pomocą metody Events.list() zaawansowanej usługi Kalendarza.
3. Wynik początkowej synchronizacji zwraca nextSyncToken dla tego kalendarza. Zapisz ten token na później.
4. Gdy EventUpdated uruchamia się, co oznacza zmianę w kalendarzu, wykonaj synchronizację przyrostową kalendarza, którego dotyczy problem, korzystając z zapisanych danych nextSyncToken. Jest to w podstawie kolejna prośba Events.list(), ale podanie parametru nextSyncToken powoduje, że odpowiedź zawiera tylko zdarzenia, które uległy zmianie od czasu ostatniej synchronizacji.
5. Sprawdź odpowiedź synchronizacji, aby dowiedzieć się, które zdarzenia zostały zaktualizowane, i odpowiednio zareaguj kodem. Możesz na przykład odnotować zmianę, zaktualizować arkusz kalkulacyjny, wysłać powiadomienia e-mailem lub wykonać inne czynności.
6. Zaktualizuj nextSyncToken zapisany dla tego kalendarza za pomocą wartości zwróconej przez żądanie synchronizacji przyrostowej. Wymusza to, aby następna operacja synchronizacji zwróciła tylko najnowsze zmiany.

Uwaga: czasami serwer unieważnia tokeny synchronizacji, co powoduje błąd 410. W takim przypadku kod powinien przeprowadzić pełną synchronizację i zastąpić wszystkie zapisane zsynchronizowane dane i tokeny tego kalendarza.

EventUpdated (można zainstalować)
authMode	Wartość z enumeracji ScriptApp.AuthMode. FULL
calendarId	Identyfikator ciągu znaków kalendarza, w którym nastąpiła aktualizacja zdarzenia. [e-mail]
triggerUid	Identyfikator reguły, która wywołała to zdarzenie. 4034124084959907503

Zdarzenia dodatku do Google Workspace

onInstall() działa automatycznie, gdy użytkownik zainstaluje dodatek.

Zainstaluj (proste)
authMode	Wartość z typu enum ScriptApp.AuthMode. FULL

Zdarzenia w aplikacji Google Chat

Więcej informacji o obiektach zdarzeń w Google Chat znajdziesz w artykule Otrzymywanie i odpowiadanie na interakcje z aplikacją Google Chat.

Zdarzenia związane z czasem

Reguły uruchamiania oparte na czasie (nazywane też regułami uruchamiania o określonej porze) umożliwiają uruchamianie skryptów o określonej godzinie lub w określonych odstępach czasu.

Czasowy (można go zainstalować)
authMode	Wartość z typu enum ScriptApp.AuthMode. FULL
day-of-month	Od 1 do 31. Ponieważ nazwa tej właściwości zawiera łączniki, dostęp do niej musi być uzyskiwany za pomocą znaku e['day-of-month'], a nie kropki. 31
day-of-week	Od 1 (poniedziałek) do 7 (niedziela). Ponieważ nazwa tej właściwości zawiera łączniki, dostęp do niej musi być uzyskiwany za pomocą znaku e['day-of-week'], a nie kropki. 7
hour	Od 0 do 23. 23
minute	Od 0 do 59. 59
month	Od 1 do 12. 12
second	Od 0 do 59. 59
timezone	Strefa czasowa. UTC
triggerUid	Identyfikator reguły, która wywołała to zdarzenie. 4034124084959907503
week-of-year	Od 1 do 52. Ponieważ nazwa tej właściwości zawiera łączniki, dostęp do niej musi być uzyskiwany za pomocą znaku e['week-of-year'], a nie kropki. 52
year	Rok. 2015