Obiekty zdarzeń

Proste aktywatory oraz reguły instalacyjne, które zezwalają na używanie Apps Script; automatycznego uruchamiania funkcji po wystąpieniu określonego zdarzenia. Po uruchomieniu reguły Apps Script przekazuje funkcję obiektu zdarzenia jako argument, zwykle nazywany e Obiekt zdarzenia zawiera informacje o kontekście, który spowodował do uruchomienia reguły. Na przykład ten przykładowy kod poniżej pokazuje prosty onEdit(e) dla skryptu Arkuszy Google, który używa obiektu zdarzenia do określenia, edytowano komórkę.

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 o polach obiektu zdarzenia dla różnych typów wyzwalaczy.

Wydarzenia w Arkuszach Google

Różne reguły specyficzne dla Arkuszy Google umożliwiają skryptom reagowanie wykonywać czynności w arkuszu kalkulacyjnym.

Otwórz

(prosty i możliwy do zainstalowania)
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

LIMITED
source

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

Spreadsheet
triggerUid

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

4034124084959907503
user

obiektu User, reprezentującego aktywnego użytkownika, o ile jest dostępna (w zależności od złożonego zestawu ograniczeń związanych z bezpieczeństwem).

amin@example.com

Zmień

(możliwy do zainstalowania)
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

FULL
changeType

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

INSERT_ROW
source

Za Spreadsheet reprezentujący plik Arkuszy Google, do którego został przypisany skrypt związane.

Spreadsheet
triggerUid

Identyfikator aktywatora, który spowodował to zdarzenie.

4034124084959907503
user

obiektu User, reprezentującego aktywnego użytkownika, o ile jest dostępna (w zależności od złożonego zestawu ograniczeń związanych z bezpieczeństwem).

amin@example.com

Edytuj

(prosty i możliwy do zainstalowania)
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

LIMITED
oldValue

Wartość komórki sprzed zmiany (jeśli miała miejsce). Dostępne tylko wtedy, gdy edytowano zakres to jedna komórka. Jeśli komórka nie zawiera poprzedniego elementu, zostanie ona nieokreślona treści.

1234
range

obiektu Range, reprezentujące komórkę lub zakres edytowanych komórek.

Range
source

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

Spreadsheet
triggerUid

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

4034124084959907503
user

obiektu User, reprezentującego aktywnego użytkownika, o ile jest dostępna (w zależności od złożonego zestawu ograniczeń związanych z bezpieczeństwem).

amin@example.com
value

Nowa wartość komórki po wprowadzeniu zmiany. Opcja dostępna tylko wtedy, gdy edytowany zakres to tylko jedną komórkę.

10

Przesłanie formularza

(możliwy do zainstalowania)
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

FULL
namedValues

Obiekt zawierający nazwy pytań i wartości z przesłanego formularza.

{
  'First Name': ['Jane'],
  'Timestamp': ['6/7/2015 20:54:13'],
  'Last Name': ['Doe']
}
range

obiektu Range, reprezentujące komórkę lub zakres edytowanych komórek.

Range
triggerUid

Identyfikator aktywatora, który spowodował 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']

Wydarzenia związane z Dokumentami Google

Wyzwalacze pozwalają Dokumentom Google reagować, gdy użytkownik otwiera dokument.

Otwórz

(prosty i możliwy do zainstalowania)
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

LIMITED
source

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

Document
triggerUid

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

4034124084959907503
user

obiektu User, reprezentującego aktywnego użytkownika, o ile jest dostępna (w zależności od złożonego zestawu ograniczeń związanych z bezpieczeństwem).

amin@example.com

Wydarzenia w Prezentacjach Google

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

Otwórz

(prosty).
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

LIMITED
source

obiektu Presentation, reprezentujący plik Prezentacji Google, z którym powiązany jest skrypt.

Presentation
user

obiektu User, reprezentującego aktywnego użytkownika, o ile jest dostępna (w zależności od złożonego zestawu ograniczeń związanych z bezpieczeństwem).

amin@example.com

Wydarzenia związane z Formularzami Google

Reguły specyficzne dla Formularzy Google pozwalają skryptom odpowiadać, gdy użytkownik edytuje formularz lub przesyła odpowiedź.

Otwórz

* (prosty i możliwy do zainstalowania)
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

LIMITED
source

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

Form
triggerUid

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

4034124084959907503
user

obiektu User, reprezentującego aktywnego użytkownika, o ile jest dostępna (w zależności od złożonego zestawu ograniczeń związanych z bezpieczeństwem).

amin@example.com

* Zdarzenie to nie następuje, gdy użytkownik otworzy formularz, by na niego odpowiedzieć. gdy edytujący otworzy formularz, aby go zmodyfikować.

Przesłanie formularza

(możliwy do zainstalowania)
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

FULL
response

obiektu FormResponse, reprezentująca odpowiedź użytkownika na formularz.

FormResponse
source

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

Form
triggerUid

Identyfikator aktywatora, który spowodował to zdarzenie.

4034124084959907503

wydarzeniach w Kalendarzu Google;

Wyzwalacze Kalendarza uruchamiają się po zaktualizowaniu wydarzeń w kalendarzu użytkownika (utworzonym edytowane lub usunięte).

Nie informują one, które zdarzenie uległo zmianie ani jak to się zmieniło. Zamiast tego wskazują, że Twój kod musi wykonać operację synchronizacji przyrostowej. by pobrać najnowsze zmiany w kalendarzu. Pełny opis zapoznaj się z Przewodnik na temat synchronizacji zasobów dla platformy Interfejs Calendar API.

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

  1. Włącz zaawansowaną usługę Kalendarz dla domeny w projekcie skryptu. Wbudowane Usługa Kalendarz nie jest wystarczająca do obsługi w tym procesie.
  2. Określ kalendarze, które mają być synchronizowane. Dla każdego takiego kalendarza Wykonaj synchronizację początkową przy użyciu zaawansowanych funkcji Kalendarza metody Events.list().
  3. Wynik początkowej synchronizacji zwraca wartość nextSyncToken dla tego kalendarza. Zachowaj ten token na później.
  4. Gdy zostanie uruchomiony wyzwalacz Apps Script EventUpdated, który wskazuje kalendarz zmiany zdarzenia, wykonaj synchronizację przyrostową. dla kalendarza, którego dotyczy problem, przy użyciu przechowywanych nextSyncToken. To jest i inną funkcję Events.list() żądania, ale podanie nextSyncToken ogranicza odpowiedź tylko do Wydarzenia, które zmieniły się od ostatniej synchronizacji.
  5. Sprawdź odpowiedź synchronizacji, by dowiedzieć się, które zdarzenia zostały zaktualizowane należy zadbać o odpowiednią reakcję kodu. Możesz na przykład zapisać zmianę, aktualizować arkusza kalkulacyjnego, wysyłać e-maili z powiadomieniami ani wykonywać innych czynności.
  6. Zaktualizuj dane nextSyncToken zapisane w tym kalendarzu na zwrócone dane za pomocą żądania synchronizacji przyrostowej. Wymusza to następną operację synchronizacji zwraca tylko najbardziej aktualne zmiany.

EventUpdated

(możliwy do zainstalowania)
authMode

Wartość z parametru ScriptApp.AuthMode typ wyliczeniowy.

FULL
calendarId

Identyfikator kalendarza, w którym nastąpiła aktualizacja wydarzenia.

susan@example.com
triggerUid

Identyfikator aktywatora, który spowodował to zdarzenie.

4034124084959907503

Zdarzenia dotyczące dodatków do Google Workspace

Uruchomiono regułę onInstall(). automatycznie, gdy użytkownik zainstaluje dodatek.

Zainstaluj

(prosty).
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

FULL

Zdarzenia w aplikacji Google Chat

Więcej informacji o obiektach zdarzeń w Google Chat znajdziesz w artykule Odbieranie interakcji w aplikacji Google Chat i odpowiadanie na nie

Zdarzenia oparte na czasie

Reguły oparte na czasie (nazywane też wyzwalaczami zegara), pozwalają na wykonywanie skryptów o określonym czasie lub na lub interwału cyklicznego.

Ograniczony czasowo (możliwy do zainstalowania)
authMode

Wartość z wyliczenia w ScriptApp.AuthMode.

FULL
day-of-month

Od 1 do 31.

Aby uzyskać dostęp do tej nazwy usługi, musisz użyć myślników. e['day-of-month'] zamiast kropki.

31
day-of-week

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

Aby uzyskać dostęp do tej nazwy usługi, musisz użyć myślników. e['day-of-week'] zamiast 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 aktywatora, który spowodował to zdarzenie.

4034124084959907503
week-of-year

Od 1 do 52.

Aby uzyskać dostęp do tej nazwy usługi, musisz użyć myślników. e['week-of-year'] zamiast kropki.

52
year

Rok.

2015