Obiekty zdarzeń

Proste aktywatory i aktywatory z możliwością zainstalowania umożliwiają Apps Script automatyczne uruchamianie funkcji po wystąpieniu określonego zdarzenia. Gdy aktywator zostanie uruchomiony, Apps Script przekazuje do funkcji obiekt zdarzenia jako argument, zwykle o nazwie e. Obiekt zdarzenia zawiera informacje o kontekście, który spowodował wywołanie wyzwalacza. Na przykład poniższy przykładowy kod pokazuje prosty onEdit(e) wyzwalacz skryptu Arkuszy Google, 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 w obiekcie zdarzenia w przypadku różnych typów reguł.

Zdarzenia Arkuszy Google

Różne wyzwalacze specyficzne dla Arkuszy Google umożliwiają skryptom reagowanie na działania użytkownika w arkuszu kalkulacyjnym.

LIMITED

Spreadsheet

4034124084959907503

amin@example.com

FULL

INSERT_ROW

Spreadsheet

4034124084959907503

amin@example.com

LIMITED

1234

Range

Spreadsheet

4034124084959907503

amin@example.com

10

FULL

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

Range

4034124084959907503

['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill',
'28', 'Susan', '25']

Zdarzenia w Dokumentach Google

Wywoływacze umożliwiają Dokumentom Google reagowanie, gdy użytkownik otwiera dokument.

LIMITED

Document

4034124084959907503

amin@example.com

Zdarzenia w Prezentacjach Google

Reguły umożliwiają Prezentacjom Google reagowanie, gdy użytkownik otwiera prezentację.

LIMITED

Presentation

amin@example.com

Zdarzenia w Formularzach Google

Wywołania specyficzne dla Formularzy Google umożliwiają skryptom reagowanie, gdy użytkownik edytuje formularz lub przesyła odpowiedź.

LIMITED

Form

4034124084959907503

amin@example.com

* To zdarzenie nie występuje, gdy użytkownik otwiera formularz, aby na niego odpowiedzieć, ale gdy edytujący otwiera formularz, aby go zmodyfikować.

FULL

FormResponse

Form

4034124084959907503

wydarzeniach w Kalendarzu Google;

Triggery Kalendarza są uruchamiane, gdy wydarzenia w kalendarzu użytkownika zostaną zaktualizowane (utworzone, edytowane lub usunięte).

Te wyzwalacze nie informują, które zdarzenie uległo zmianie ani w jaki sposób. Oznacza to, że kod musi wykonać przyrostową operację synchronizacji, aby uwzględnić ostatnie zmiany w kalendarzu. Pełny opis tej procedury znajdziesz w przewodniku po synchronizowaniu zasobów w interfejsie Calendar API.

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

1. Włącz usługę zaawansowaną Kalendarza w projekcie skryptu. Wbudowana usługa Kalendarz nie jest wystarczająca w przypadku tego przepływu pracy.
2. Określ, które kalendarze mają być synchronizowane. W przypadku każdego takiego kalendarza wykonaj początkową synchronizację za pomocą metody Events.list() usługi zaawansowanej Kalendarza.
3. Wynik początkowej synchronizacji zwraca wartość nextSyncToken dla tego kalendarza. Zapisz ten token do późniejszego użycia.
4. Gdy uruchomi się wyzwalacz Apps Script EventUpdated wskazujący zmianę wydarzenia w kalendarzu, wykonaj synchronizację przyrostową w przypadku kalendarza, którego dotyczy zmiana, używając zapisanego nextSyncToken. Jest to w zasadzie kolejne żądanie Events.list() , ale podanie parametru nextSyncToken ogranicza odpowiedź tylko do zdarzeń, które uległy zmianie od czasu ostatniej synchronizacji.
5. Sprawdź odpowiedź synchronizacji, aby dowiedzieć się, które zdarzenia zostały zaktualizowane, i odpowiednio zareagować w kodzie. Możesz na przykład zarejestrować zmianę, zaktualizować arkusz kalkulacyjny, wysłać powiadomienia e-mail lub wykonać inne działania.
6. Zaktualizuj nextSyncToken zapisany dla tego kalendarza, używając wartości zwróconej przez żądanie synchronizacji przyrostowej. Wymusza to, aby następna operacja synchronizacji zwracała tylko najnowsze zmiany.

FULL

susan@example.com

4034124084959907503

Zdarzenia dodatków do Google Workspace

onInstall()Wywoływacz uruchamia się automatycznie, gdy użytkownik zainstaluje dodatek.

FULL

Zdarzenia w aplikacji Google Chat

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

Wydarzenia oparte na czasie

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

FULL

31

7

23

59

12

59

UTC

4034124084959907503

52

2015