Class Trigger

Trigger

Un trigger di script.

Metodi

MetodoTipo restituitoBreve descrizione
getEventType()EventTypeRestituisce il tipo di evento su cui si attiva l'attivatore.
getHandlerFunction()StringRestituisce la funzione che verrà chiamata quando l'attivatore si attiva.
getTriggerSource()TriggerSourceRestituisce l'origine degli eventi che attiveranno l'attivatore.
getTriggerSourceId()StringRestituisce l'ID specifico della sorgente.
getUniqueId()StringRestituisce 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