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 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 z możliwością zainstalowania) |
|
---|---|
authMode |
Wartość z typu enum LIMITED |
source |
Obiekt Spreadsheet |
triggerUid |
Identyfikator reguły, która spowodowała to zdarzenie (tylko reguły instalowane). 4034124084959907503 |
user |
Obiekt amin@example.com |
Zmień(można zainstalować) |
|
---|---|
authMode |
Wartość z typu enum FULL |
changeType |
typ zmiany ( INSERT_ROW |
source |
Obiekt
Spreadsheet |
triggerUid |
Identyfikator reguły, która wywołała to zdarzenie. 4034124084959907503 |
user |
Obiekt amin@example.com |
Edytuj(proste i z możliwością zainstalowania) |
|
---|---|
authMode |
Wartość z typu enum 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 |
source |
Obiekt Spreadsheet |
triggerUid |
Identyfikator reguły, która spowodowała to zdarzenie (tylko reguły instalowane). 4034124084959907503 |
user |
Obiekt amin@example.com |
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żliwość zainstalowania) |
|
---|---|
authMode |
Wartość z typu enum 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 |
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', 'amin@example.com', 'Bob', '27', 'Bill', '28', 'Susan', '25'] |
Zdarzenia Dokumentów Google
Wyzwalacze umożliwiają Dokumentom Google reagowanie, gdy użytkownik otworzy dokument.
Otwórz(proste i z możliwością zainstalowania) |
|
---|---|
authMode |
Wartość z typu enum LIMITED |
source |
Obiekt Document |
triggerUid |
Identyfikator reguły, która spowodowała to zdarzenie (tylko reguły instalowane). 4034124084959907503 |
user |
Obiekt amin@example.com |
Zdarzenia w Prezentacjach Google
Wyzwalacze umożliwiają Prezentacjom Google reagowanie, gdy użytkownik otworzy prezentację.
Otwórz(proste) |
|
---|---|
authMode |
Wartość z typu enum LIMITED |
source |
Obiekt Presentation |
user |
Obiekt amin@example.com |
zdarzenia w Formularzach Google,
Wyzwalacze związane z Formularzami Google umożliwiają skryptom reagowanie, gdy użytkownik edytuje formularz lub przesyła odpowiedź.
Otwórz* (proste i możliwe do zainstalowania) |
|
---|---|
authMode |
Wartość z typu enum LIMITED |
source |
Obiekt Form |
triggerUid |
Identyfikator reguły, która spowodowała to zdarzenie (tylko reguły instalowane). 4034124084959907503 |
user |
Obiekt amin@example.com |
* To zdarzenie nie występuje, gdy użytkownik otwiera formularz, aby przesłać odpowiedź, ale gdy edytor otwiera formularz, aby go zmodyfikować.
Przesłanie formularza(można zainstalować) |
|
---|---|
authMode |
Wartość z typu enum FULL |
response |
Obiekt FormResponse |
source |
Obiekt 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:
- Włącz usługę zaawansowaną Kalendarz w projekcie skryptu. Wbudowana usługa Kalendarz nie wystarcza do tego procesu.
- Określ, które kalendarze mają być synchronizowane. W przypadku każdego takiego kalendarza wykonaj operację pierwszego synchronizowania za pomocą metody Events.list() usługi Kalendarza na poziomie zaawansowanym.
- Wynik początkowej synchronizacji zwraca
nextSyncToken
dla tego kalendarza. Zapisz ten token na później. - Gdy
EventUpdated
uruchamia się, co oznacza zmianę w kalendarzu, wykonaj synchronizację przyrostową kalendarza, którego dotyczy problem, używając zapisanegonextSyncToken
. Jest to w podstawie kolejna prośba Events.list(), ale podanie parametrunextSyncToken
powoduje, że odpowiedź zawiera tylko zdarzenia, które uległy zmianie od czasu ostatniej synchronizacji. - 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.
- Zaktualizuj
nextSyncToken
przechowywane w przypadku tego kalendarza za pomocą wartości zwróconej przez żądanie synchronizacji cząstkowej. Wymusza to, aby następna operacja synchronizacji zwróciła tylko najnowsze zmiany.
EventUpdated(można zainstalować) |
|
---|---|
authMode |
Wartość z enumeracji FULL |
calendarId |
Identyfikator ciągu znaków kalendarza, w którym nastąpiła aktualizacja zdarzenia. susan@example.com |
triggerUid |
Identyfikator reguły, która wywołała to zdarzenie. 4034124084959907503 |
Zdarzenia związane z dodatkami do Google Workspace
Reguła onInstall()
działa automatycznie, gdy użytkownik zainstaluje dodatek.
Zainstaluj(proste) |
|
---|---|
authMode |
Wartość z typu enum 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 (zwane też regułami uruchamiania o określonej porze) umożliwiają uruchamianie skryptów w określonym czasie lub w określonych odstępach czasu.
Czasowy (można go zainstalować) | |
---|---|
authMode |
Wartość z typu enum FULL |
day-of-month |
Od Ponieważ nazwa tej właściwości zawiera łączniki, dostęp do niej musi być uzyskiwany za pomocą znaku 31 |
day-of-week |
Od Ponieważ nazwa tej właściwości zawiera łączniki, dostęp do niej musi być uzyskiwany za pomocą znaku 7 |
hour |
Od 23 |
minute |
Od 59 |
month |
Od 12 |
second |
Od 59 |
timezone |
Strefa czasowa. UTC |
triggerUid |
Identyfikator reguły, która wywołała to zdarzenie. 4034124084959907503 |
week-of-year |
Od Ponieważ nazwa tej właściwości zawiera łączniki, dostęp do niej musi być uzyskiwany za pomocą znaku 52 |
year |
Rok. 2015 |