Trigger semplici e attivabili installabili consentono ad Apps Script di eseguire automaticamente una funzione se si verifica un determinato evento. Quando si attiva un attivatore, Apps Script passa alla funzione un oggetto evento come argomento, generalmente chiamato e
. L'oggetto evento contiene informazioni sul contesto che ha causato l'attivazione dell'attivatore. Ad esempio, il codice di esempio riportato di seguito mostra un semplice attivatore onEdit(e)
per uno script di Fogli Google che utilizza l'oggetto evento per determinare quale cella è stata modificata.
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());
}
Questa pagina descrive in dettaglio i campi dell'oggetto evento per i diversi tipi di attivatori.
Eventi Fogli Google
I vari attivatori specifici di Fogli Google consentono agli script di rispondere alle azioni di un utente in un foglio di lavoro.
Apri(semplice e installabile) |
|
---|---|
authMode |
Un valore dell'enumerazione LIMITED |
source |
Un oggetto Spreadsheet |
triggerUid |
ID dell'attivatore che ha generato questo evento (solo trigger installabili). 4034124084959907503 |
user |
Un oggetto amin@example.com |
Cambio(installabile) |
|
---|---|
authMode |
Un valore dell'enumerazione FULL |
changeType |
Il tipo di modifica ( INSERT_ROW |
source |
Un oggetto
Spreadsheet |
triggerUid |
ID dell'attivatore che ha generato questo evento. 4034124084959907503 |
user |
Un oggetto amin@example.com |
Modifica(semplice e installabile) |
|
---|---|
authMode |
Un valore dell'enumerazione LIMITED |
oldValue |
Valore della cella prima della modifica, se presente. Disponibile solo se l'intervallo modificato è una singola cella. Non sarà definito se la cella non aveva contenuti precedenti. 1234 |
range |
Un oggetto Range |
source |
Un oggetto Spreadsheet |
triggerUid |
ID dell'attivatore che ha generato questo evento (solo trigger installabili). 4034124084959907503 |
user |
Un oggetto amin@example.com |
value |
Nuovo valore della cella dopo la modifica. Disponibile solo se l'intervallo modificato è costituito da una singola cella. 10 |
Invio modulo(installabile) |
|
---|---|
authMode |
Un valore dell'enumerazione FULL |
namedValues |
Un oggetto contenente i nomi e i valori delle domande dell'invio del modulo. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] } |
range |
Un oggetto Range |
triggerUid |
ID dell'attivatore che ha generato questo evento. 4034124084959907503 |
values |
Array con i valori nello stesso ordine in cui appaiono nel foglio di lavoro. ['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill', '28', 'Susan', '25'] |
Eventi di Documenti Google
Gli attivatori consentono a Documenti Google di rispondere quando un utente apre un documento.
Apri(semplice e installabile) |
|
---|---|
authMode |
Un valore dell'enumerazione LIMITED |
source |
Un oggetto Document |
triggerUid |
ID dell'attivatore che ha generato questo evento (solo trigger installabili). 4034124084959907503 |
user |
Un oggetto amin@example.com |
Eventi di Presentazioni Google
Gli attivatori consentono a Presentazioni Google di rispondere quando un utente apre una presentazione.
Apri(semplice) |
|
---|---|
authMode |
Un valore dell'enumerazione LIMITED |
source |
Un oggetto Presentation |
user |
Un oggetto amin@example.com |
Eventi di Moduli Google
Gli attivatori specifici di Moduli Google consentono agli script di rispondere quando un utente modifica un modulo o invia una risposta.
Apri* (semplice e installabile) |
|
---|---|
authMode |
Un valore dell'enumerazione LIMITED |
source |
Un oggetto Form |
triggerUid |
ID dell'attivatore che ha generato questo evento (solo trigger installabili). 4034124084959907503 |
user |
Un oggetto amin@example.com |
* Questo evento non si verifica quando un utente apre un modulo per rispondere, ma piuttosto quando un editor lo apre per modificarlo.
Invio modulo(installabile) |
|
---|---|
authMode |
Un valore dell'enumerazione FULL |
response |
Un oggetto FormResponse |
source |
Un oggetto Form |
triggerUid |
ID dell'attivatore che ha generato questo evento. 4034124084959907503 |
Eventi di Google Calendar
Gli attivatori di Calendar si attivano quando gli eventi nel calendario di un utente vengono aggiornati (creati, modificati o eliminati).
Questi attivatori non indicano quale evento è stato modificato o come è cambiato. Indicano invece che il codice deve eseguire un'operazione di sincronizzazione incrementale per recuperare le modifiche recenti al calendario. Per una descrizione completa di questa procedura, consulta la Guida alla sincronizzazione delle risorse per l'API Calendar.
Per eseguire la sincronizzazione con Calendar in Apps Script, procedi nel seguente modo:
- Abilita il servizio avanzato di Calendar per il progetto di script. Il servizio Calendar integrato non è sufficiente per questo flusso di lavoro.
- Determina i calendari da sincronizzare. Per ciascun calendario di questo tipo, esegui un'operazione di sincronizzazione iniziale utilizzando il metodo Events.list() del servizio avanzato di Calendar.
- Il risultato della sincronizzazione iniziale restituisce un valore
nextSyncToken
per quel calendario. Archivia questo token per utilizzarlo in seguito. - Quando si attiva l'attivatore
EventUpdated
di Apps Script per indicare una modifica di evento del calendario, esegui una sincronizzazione incrementale per il calendario interessato utilizzando ilnextSyncToken
archiviato. In sostanza, si tratta di un'altra richiesta Events.list(), ma fornirenextSyncToken
limita la risposta solo agli eventi che sono cambiati dall'ultima sincronizzazione. - Esamina la risposta della sincronizzazione per capire quali eventi sono stati aggiornati e affinché il tuo codice risponda in modo appropriato. Ad esempio, puoi registrare la modifica, aggiornare un foglio di lavoro, inviare notifiche via email o eseguire altre azioni.
- Aggiorna i
nextSyncToken
archiviati per il calendario con quello restituito dalla richiesta di sincronizzazione incrementale. In questo modo l'operazione di sincronizzazione successiva restituisce solo le modifiche più recenti.
EventUpdated(installabile) |
|
---|---|
authMode |
Un valore dell'enumerazione
FULL |
calendarId |
L'ID stringa del calendario in cui si è verificato l'aggiornamento dell'evento. susan@example.com |
triggerUid |
ID dell'attivatore che ha generato questo evento. 4034124084959907503 |
Eventi dei componenti aggiuntivi di Google Workspace
L'attivatore onInstall()
viene eseguito
automaticamente quando un utente installa un componente aggiuntivo.
Installa(semplice) |
|
---|---|
authMode |
Un valore dell'enumerazione FULL |
Eventi dell'app Google Chat
Per saperne di più sugli oggetti evento in Google Chat, vedi Ricevere e rispondere alle interazioni con l'app Google Chat.
Eventi a tempo
I trigger basati sul tempo (chiamati anche trigger di orologio) consentono l'esecuzione degli script in un momento specifico o in un intervallo ricorrente.
A tempo (installabili) | |
---|---|
authMode |
Un valore dell'enumerazione FULL |
day-of-month |
Tra Poiché questo nome di proprietà contiene trattini, è necessario accedervi tramite 31 |
day-of-week |
Tra Poiché questo nome di proprietà contiene trattini, è necessario accedervi tramite 7 |
hour |
Tra 23 |
minute |
Tra 59 |
month |
Tra 12 |
second |
Tra 59 |
timezone |
Il fuso orario. UTC |
triggerUid |
ID dell'attivatore che ha generato questo evento. 4034124084959907503 |
week-of-year |
Tra Poiché questo nome di proprietà contiene trattini, è necessario accedervi tramite 52 |
year |
L'anno. 2015 |