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 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 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ń).

amin@example.com

Zmień

(można zainstalować)
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ń).

amin@example.com

Edytuj

(proste i z możliwością 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ń).

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 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', '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 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ń).

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 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ń).

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 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, reprezentujący aktywnego użytkownika (jeśli jest dostępny) (w zależności od złożonego zestawu ograniczeń zabezpieczeń).

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 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() usługi Kalendarza na poziomie zaawansowanym.
  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, używając zapisanego 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 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 ScriptApp.AuthMode.

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 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 (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 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