Class Trigger

Trigger

Un attivatore di script.

Metodi

Metodo	Tipo restituito	Breve descrizione
getEventType()	EventType	Restituisce il tipo di evento in cui viene attivato il trigger.
getHandlerFunction()	String	Restituisce la funzione chiamata quando viene attivato il trigger.
getTriggerSource()	TriggerSource	Restituisce l'origine degli eventi che causano l'attivazione del trigger.
getTriggerSourceId()	String	Restituisce l'ID specifico dell'origine.
getUniqueId()	String	Restituisce un identificatore univoco che può essere utilizzato per distinguere i trigger l'uno dall'altro.

Documentazione dettagliata

getEventType()

Restituisce il tipo di evento in cui viene attivato il trigger.

const triggers = ScriptApp.getProjectTriggers();
for (let 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
  }
}

Indietro

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 chiamata quando viene attivato il trigger.

// Create a trigger for the script.
ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('id of my spreadsheet')
    .onEdit()
    .create();
Logger.log(ScriptApp.getProjectTriggers()[0]
               .getHandlerFunction());  // logs "myFunction"

Indietro

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 causano l'attivazione del trigger.

Ad esempio, un attivatore onEdit di un foglio di lavoro restituisce SPREADSHEETS o un attivatore basato sul tempo restituisce CLOCK.

const triggers = ScriptApp.getProjectTriggers();
for (let 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`);
  }
}

Indietro

TriggerSource: l'editore per cui viene attivato il 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

---

getTriggerSourceId()

Restituisce l'ID specifico dell'origine.

Ad esempio, se l'origine del trigger è un foglio di lavoro, questo è l'ID del foglio di lavoro. Per gli eventi dell'orologio viene restituito null.

Indietro

String: l'ID dell'entità nel publisher per cui viene attivato il 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

---

getUniqueId()

Restituisce un identificatore univoco che può essere utilizzato per distinguere i trigger l'uno dall'altro.

Indietro

String: l'identificatore univoco del 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