Obiekty zdarzeń

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

Aktywatory proste i integracyjne reguły pozwalają automatycznie uruchamiać funkcję Apps Script w przypadku wystąpienia określonego zdarzenia. Po uruchomieniu aktywatora Apps Script przekazuje obiekt zdarzenia jako argument, zwykle nazywany e. Obiekt zdarzenia zawiera informacje o kontekście, który spowodował uruchomienie reguły. Poniższy przykładowy kod pokazuje prostą regułę onEdit(e) dla skryptu Arkuszy Google, która wykorzystuje obiekt zdarzenia do określenia, która komórka została zmieniona.

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 znajdują się szczegółowe informacje na temat pól obiektu zdarzenia w przypadku różnych typów reguł.

Zdarzenia dotyczące Arkuszy Google

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

Otwórz

(prosty i instalacyjny)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

LIMITED
source

Obiekt Spreadsheet reprezentujący plik Arkuszy Google, z którym jest powiązany skrypt.

Spreadsheet
triggerUid

Identyfikator aktywatora, który wywołał to zdarzenie (tylko reguły możliwe do zainstalowania).

4034124084959907503
user

Obiekt User reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń).

amin@example.com

Zmień

(można zainstalować)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

FULL
changeType

Typ zmiany (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW, REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT lub OTHER).

INSERT_ROW
triggerUid

Identyfikator aktywatora, który wywoł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ń).

amin@example.com

Edytuj

(prosty i instalacyjny)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

LIMITED
oldValue

Wartość komórki przed zmianą (jeśli występuje). Dostępne tylko wtedy, gdy edytowany zakres obejmuje pojedynczą komórkę. Jeśli komórka nie zawierała poprzedniej treści, zostanie ona nieokreślona.

1234
range

Obiekt Range reprezentujący komórkę lub zakres komórek, które zostały zmodyfikowane.

Range
source

Obiekt Spreadsheet reprezentujący plik Arkuszy Google, z którym jest powiązany skrypt.

Spreadsheet
triggerUid

Identyfikator aktywatora, który wywołał to zdarzenie (tylko reguły możliwe do zainstalowania).

4034124084959907503
user

Obiekt User reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń).

amin@example.com
value

Nowa wartość komórki po edycji. Dostępne tylko wtedy, gdy edytowany zakres obejmuje pojedynczą komórkę.

10

Przesłanie formularza

(można zainstalować)
authMode

Wartość wyliczenia 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 zmodyfikowane.

Range
triggerUid

Identyfikator aktywatora, który wywołał to zdarzenie.

4034124084959907503
values

Tablica z wartościami w tej 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 w Dokumentach Google

Aktywatory umożliwiają użytkownikom Dokumentów Google odpowiadanie na otwieranie dokumentu.

Otwórz

(prosty i instalacyjny)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

LIMITED
source

Obiekt Document reprezentujący plik Dokumentów Google, z którym jest powiązany skrypt.

Document
triggerUid

Identyfikator aktywatora, który wywołał to zdarzenie (tylko reguły możliwe do zainstalowania).

4034124084959907503
user

Obiekt User reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń).

amin@example.com

Wydarzenia w Prezentacjach Google

Dzięki regułom Prezentacje Google mogą odpowiadać na próby otwarcia prezentacji przez użytkownika.

Otwórz

(prosty)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

LIMITED
source

Obiekt Presentation reprezentujący plik Prezentacji Google, z którym 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ń).

amin@example.com

Wydarzenia w Formularzach Google

Reguły właściwe dla Formularzy Google umożliwiają skryptom odpowiadanie na zmiany, gdy użytkownik edytuje lub prześle odpowiedź.

Otwórz

* (Prosty i możliwy do zainstalowania)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

LIMITED
source

Obiekt Form reprezentujący plik Formularzy Google, z którym jest powiązany skrypt.

Form
triggerUid

Identyfikator aktywatora, który wywołał to zdarzenie (tylko reguły możliwe do zainstalowania).

4034124084959907503
user

Obiekt User reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń).

amin@example.com

* To zdarzenie nie występuje, gdy użytkownik otworzy formularz, a jedynie gdy edytor je otworzy.

Przesłanie formularza

(można zainstalować)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

FULL
response

Obiekt FormResponse reprezentujący odpowiedź na formularz jako całość.

FormResponse
source

Obiekt Form reprezentujący plik Formularzy Google, z którym jest powiązany skrypt.

Form
triggerUid

Identyfikator aktywatora, który wywołał to zdarzenie.

4034124084959907503

Google Calendar events (Wydarzenia w Kalendarzu Google)

Reguły kalendarza są uruchamiane po zaktualizowaniu wydarzeń w kalendarzu użytkownika (utworzeniu, zmodyfikowaniu lub usunięciu).

Te reguły nie wskazują, które zdarzenie się zmieniło lub jak się zmieniło. Zamiast tego wskazują, że Twój kod musi wykonać przyrostową operację synchronizacji, aby odczytać najnowsze zmiany w kalendarzu. Pełny opis tej procedury znajdziesz w przewodniku po synchronizacji zasobów interfejsu Calendar API.

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

  1. Włącz usługę zaawansowaną Kalendarza w projekcie skryptu. Wbudowana usługa Kalendarza nie wystarcza do tego przepływu pracy.
  2. Określ, które kalendarze mają być synchronizowane. W przypadku każdego takiego kalendarza przeprowadź integralną synchronizację przy użyciu zaawansowanej usługi Kalendarz..
  3. Wynik początkowej synchronizacji zwraca nextSyncToken w tym kalendarzu. Zapisz ten token do późniejszego użycia.
  4. Uruchomienie reguły Apps Script EventUpdated wskazującej zmianę wydarzenia w kalendarzu wykonaj przyrostową synchronizację odpowiedniego kalendarza przy użyciu zapisanego nextSyncToken. W zasadzie jest to kolejne żądanie Events.list(), ale określenie właściwości nextSyncToken ogranicza tylko odpowiedzi na zdarzenia, które zmieniły się od ostatniej synchronizacji.
  5. Sprawdź odpowiedź synchronizacji, aby dowiedzieć się, które zdarzenia zostały zaktualizowane, i właściwy kod. Możesz na przykład zapisać zmianę, zaktualizować arkusz kalkulacyjny, wysłać e-maila z powiadomieniem lub wykonać inne czynności.
  6. Zaktualizuj nextSyncToken zapisany dla tego kalendarza z adresem zwracanym przez przyrostowy wniosek o synchronizację. Wymusza to wykonanie następnej synchronizacji w taki sposób, aby zwracały tylko najnowsze zmiany.

Zaktualizowano wydarzenie

(można zainstalować)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

FULL
calendarId

Identyfikator ciągu znaków kalendarza, w którym wystąpiła aktualizacja zdarzenia.

susan@example.com
triggerUid

Identyfikator aktywatora, który wywołał to zdarzenie.

4034124084959907503

Zdarzenia dotyczące dodatków

Reguła onInstall() uruchamia się automatycznie, gdy użytkownik instaluje dodatek.

Zainstaluj

(prosty)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

FULL

Zdarzenia czasowe

Reguły oparte na czasie (zwane też wyzwalaczami zegara) pozwalają na wykonywanie skryptów w określonym czasie lub cyklicznie.

Oparte na czasie (można zainstalować)
authMode

Wartość wyliczenia ScriptApp.AuthMode.

FULL
day-of-month

Pomiędzy 1 a 31.

Nazwa właściwości zawiera łączniki, dlatego musisz je otworzyć przez e['day-of-month'], a nie notację.

31
day-of-week

Między 1 (poniedziałek) a 7 (niedziela).

Nazwa właściwości zawiera łączniki, dlatego musisz je otworzyć przez e['day-of-week'], a nie notację.

7
hour

Pomiędzy 0 a 23.

23
minute

Pomiędzy 0 a 59.

59
month

Pomiędzy 1 a 12.

12
second

Pomiędzy 0 a 59.

59
timezone

Strefa czasowa.

UTC
triggerUid

Identyfikator aktywatora, który wywołał to zdarzenie.

4034124084959907503
week-of-year

Pomiędzy 1 a 52.

Nazwa właściwości zawiera łączniki, dlatego musisz je otworzyć przez e['week-of-year'], a nie notację.

52
year

Rok.

2015