Un trigger di script.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getEventType() | EventType | Restituisce il tipo di evento su cui si attiva l'attivatore. |
getHandlerFunction() | String | Restituisce la funzione che verrà chiamata quando l'attivatore si attiva. |
getTriggerSource() | TriggerSource | Restituisce l'origine degli eventi che attiveranno l'attivatore. |
getTriggerSourceId() | String | Restituisce l'ID specifico della sorgente. |
getUniqueId() | String | Restituisce un identificatore univoco che può essere utilizzato per distinguere gli attivatori tra loro. |
Documentazione dettagliata
getEventType()
Restituisce il tipo di evento su cui si attiva l'attivatore.
var triggers = ScriptApp.getProjectTriggers(); for (var i = 0; i < triggers.length; i++) { if (triggers[i].getEventType() == ScriptApp.EventType.CLOCK) { // Some code here - other options are: // ScriptApp.EventType.ON_EDIT // ScriptApp.EventType.ON_FORM_SUBMIT // ScriptApp.EventType.ON_OPEN } }
Invio
EventType
: il tipo di evento per cui questo è un trigger.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.scriptapp
getHandlerFunction()
Restituisce la funzione che verrà chiamata quando l'attivatore si attiva.
// Create a trigger for the script. ScriptApp.newTrigger('myFunction').forSpreadsheet('id of my spreadsheet').onEdit().create(); Logger.log(ScriptApp.getProjectTriggers()[0].getHandlerFunction()); // logs "myFunction"
Invio
String
: il nome del metodo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.scriptapp
getTriggerSource()
Restituisce l'origine degli eventi che attiveranno l'attivatore.
Ad esempio, un trigger onEdit per un foglio di lavoro restituirà SPREADsheetsS oppure un trigger basato sul tempo restituisce CLOCK.
var triggers = ScriptApp.getProjectTriggers(); for (var i = 0; i < triggers.length; i++) { if (triggers[i].getTriggerSource() == ScriptApp.TriggerSource.CLOCK) { Logger.log(triggers[i].getUniqueId() + " source is clock"); } else if (triggers[i].getTriggerSource() == ScriptApp.TriggerSource.SPREADSHEETS) { Logger.log(triggers[i].getUniqueId() + " source is spreadsheets"); } }
Invio
TriggerSource
: il publisher per cui attiva l'attivatore
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.scriptapp
getTriggerSourceId()
Restituisce l'ID specifico della sorgente.
Ad esempio, se l'origine trigger è un foglio di lavoro, questo sarà l'ID del in un foglio di lavoro. Per gli eventi orologio viene restituito un valore nullo.
Invio
String
: l'ID dell'entità nel publisher per cui questo è un attivatore
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.scriptapp
getUniqueId()
Restituisce un identificatore univoco che può essere utilizzato per distinguere gli attivatori tra loro.
Invio
String
: l'identificatore univoco dell'attivatore
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.scriptapp