Oggetti evento

Trigger semplici e attivatori installabili consentono ad Apps Script eseguire automaticamente una funzione se si verifica un determinato evento. Quando un attivatore si attiva, Apps Script passa la funzione a un oggetto evento come argomento, in genere chiamato e. L'oggetto evento contiene informazioni sul contesto che ha causato l'errore il trigger per l'attivazione. Ad esempio, il codice di esempio riportato di seguito mostra un semplice 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 nell'oggetto evento per diversi tipi di trigger.

Gli eventi prodotti da trigger installabili contengono un'etichetta triggerUid che identifica il trigger che ha generato l'evento. Questa opzione è utile per gli script con più attivatori installabili.

Eventi di Fogli Google

I vari attivatori specifici di Fogli Google consentono agli script di rispondere alle azioni in un foglio di lavoro.

Apri (semplice e installabile)
authMode	Un valore dall'enumerazione ScriptApp.AuthMode. LIMITED
source	Un Spreadsheet che rappresenta il file di Fogli Google a cui è associato lo script. Spreadsheet
triggerUid	ID del trigger che ha generato questo evento (solo trigger installabili). 4034124084959907503
user	Un oggetto User, che rappresenta l'utente attivo, se disponibile in base a un complesso insieme di limitazioni di sicurezza. [e-mail]

Cambia (installabile)
authMode	Un valore dall'enumerazione ScriptApp.AuthMode. FULL
changeType	Il tipo di modifica (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW, REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT o OTHER). INSERT_ROW
source	Un Spreadsheet che rappresenta il file di Fogli Google a cui viene indirizzato lo script limitato. Spreadsheet
triggerUid	ID del trigger che ha generato questo evento. 4034124084959907503
user	Un oggetto User, che rappresenta l'utente attivo, se disponibile in base a un complesso insieme di limitazioni di sicurezza. [e-mail]

Modifica (semplice e installabile)
authMode	Un valore dall'enumerazione ScriptApp.AuthMode. LIMITED
oldValue	Valore della cella prima della modifica, se presente. Disponibile solo se lo stato modificato è una singola cella. Non sarà definito se la cella non ha avuto contenuti. 1234
range	Un oggetto Range, che rappresenta la cella o l'intervallo di celle che sono state modificate. Range
source	Un Spreadsheet che rappresenta il file di Fogli Google a cui è associato lo script. Spreadsheet
triggerUid	ID del trigger che ha generato questo evento (solo trigger installabili). 4034124084959907503
user	Un oggetto User, che rappresenta l'utente attivo, se disponibile in base a un complesso insieme di limitazioni di sicurezza. [e-mail]
value	Nuovo valore della cella dopo la modifica. Disponibile solo se l'intervallo modificato è un singola cella. 10

Invio modulo (installabile)
Attenzione:assicurati di utilizzare questo attivatore di invio modulo con SpreadsheetTriggerBuilder.
authMode	Un valore dall'enumerazione ScriptApp.AuthMode. 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, che rappresenta la cella o l'intervallo di celle che sono state modificate. Range
triggerUid	ID del trigger che ha generato questo evento. 4034124084959907503
values	Matrice con valori nello stesso ordine in cui vengono visualizzati nel foglio di lavoro. ['2015/05/04 15:00', '[e-mail]', '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 dall'enumerazione ScriptApp.AuthMode. LIMITED
source	Un oggetto Document, che rappresentano il file di Documenti Google a cui è associato lo script. Document
triggerUid	ID del trigger che ha generato questo evento (solo trigger installabili). 4034124084959907503
user	Un oggetto User, che rappresenta l'utente attivo, se disponibile in base a un complesso insieme di limitazioni di sicurezza. [e-mail]

Eventi di Presentazioni Google

Gli attivatori consentono a Presentazioni Google di rispondere quando un utente apre una presentazione.

Apri (semplice)
authMode	Un valore dall'enumerazione ScriptApp.AuthMode. LIMITED
source	Un oggetto Presentation, che rappresentano il file di Presentazioni Google a cui è associato lo script. Presentation
user	Un oggetto User, che rappresenta l'utente attivo, se disponibile in base a un complesso insieme di limitazioni di sicurezza. [e-mail]

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 dall'enumerazione ScriptApp.AuthMode. LIMITED
source	Un oggetto Form, che rappresentano il file di Moduli Google a cui è associato lo script. Form
triggerUid	ID del trigger che ha generato questo evento (solo trigger installabili). 4034124084959907503
user	Un oggetto User, che rappresenta l'utente attivo, se disponibile in base a un complesso insieme di limitazioni di sicurezza. [e-mail]

* Questo evento non si verifica quando un utente apre un modulo per rispondere, ma quando un editor apre il modulo per modificarlo.

Invio modulo (installabile)
Attenzione:assicurati di utilizzare questo attivatore di invio modulo con FormTriggerBuilder.
authMode	Un valore dall'enumerazione ScriptApp.AuthMode. FULL
response	Un oggetto FormResponse, che rappresentano la risposta dell'utente al modulo nel suo insieme. FormResponse
source	Un oggetto Form, che rappresentano il file di Moduli Google a cui è associato lo script. Form
triggerUid	ID del trigger che ha generato questo evento. 4034124084959907503

Eventi di Google Calendar

L'attivazione di Calendar quando gli eventi nel calendario di un utente vengono aggiornati (creati, modificati o eliminati).

Questi attivatori non indicano quale evento è cambiato 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, Guida alla sincronizzazione delle risorse per API Calendar.

Per eseguire la sincronizzazione con Calendar in Apps Script, segui questi passaggi:

1. Attiva il servizio avanzato di Calendar per del progetto script. Lo strumento Il servizio Calendar non è sufficiente per questo flusso di lavoro.
2. Stabilisci quali calendari sincronizzare. Per ciascun calendario, Eseguire una sincronizzazione iniziale dell'applicazione utilizzando la classe di controllo Metodo Events.list().
3. Il risultato della sincronizzazione iniziale restituisce un valore nextSyncToken per quel calendario. Archivia questo token per utilizzarlo in un secondo momento.
4. Quando si attiva l'attivatore EventUpdated di Apps Script che indica un calendario modifica dell'evento, eseguire una sincronizzazione incrementale per il calendario interessato utilizzando i nextSyncToken archiviati. Questo è essenzialmente un altro Events.list() richiesta, ma l'invio del nextSyncToken limita la risposta solo che sono cambiati dall'ultima sincronizzazione.
5. Esamina la risposta della sincronizzazione per sapere quali eventi sono stati aggiornati e fai in modo che 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.
6. Aggiorna il nextSyncToken che hai archiviato per quel calendario con quello restituito dalla richiesta di sincronizzazione incrementale. Questa operazione forza l'esecuzione della successiva operazione di sincronizzazione restituisce solo le modifiche più recenti.

Attenzione: a volte i token di sincronizzazione vengono invalidati dal server, causando Errore 410. In questi casi, il codice dovrebbe eseguire una sincronizzazione completa e sostituisci tutti i dati e i token sincronizzati archiviati che hai per quel calendario.

EventUpdated (installabile)
authMode	Un valore dal parametro ScriptApp.AuthMode enum. FULL
calendarId	L'ID stringa del calendario in cui si è verificato l'aggiornamento dell'evento. [e-mail]
triggerUid	ID del trigger che ha generato questo evento. 4034124084959907503

Eventi del componente aggiuntivo di Google Workspace

L'attivatore onInstall() viene eseguito automaticamente quando un utente installa un componente aggiuntivo.

Installa (semplice)
authMode	Un valore dall'enumerazione ScriptApp.AuthMode. 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

Trigger basati sul tempo (chiamati anche trigger orologio) consentono di eseguire gli script in un determinato momento o su una un intervallo ricorrente.

A tempo (installabile)
authMode	Un valore dall'enumerazione ScriptApp.AuthMode. FULL
day-of-month	Tra 1 e 31. Poiché il nome di questa proprietà contiene trattini, è necessario accedervi tramite e['day-of-month'] al posto della notazione punto. 31
day-of-week	Tra 1 (lunedì) e 7 (domenica). Poiché il nome di questa proprietà contiene trattini, è necessario accedervi tramite e['day-of-week'] al posto della notazione punto. 7
hour	Tra 0 e 23. 23
minute	Tra 0 e 59. 59
month	Tra 1 e 12. 12
second	Tra 0 e 59. 59
timezone	Il fuso orario. UTC
triggerUid	ID del trigger che ha generato questo evento. 4034124084959907503
week-of-year	Tra 1 e 52. Poiché il nome di questa proprietà contiene trattini, è necessario accedervi tramite e['week-of-year'] al posto della notazione punto. 52
year	L'anno. 2015