Class TriggerBuilder

TriggerBuilder

Un generatore generico per i trigger di script.

Metodi

MetodoTipo restituitoBreve descrizione
forDocument(document)DocumentTriggerBuilderCrea e restituisce un elemento DocumentTriggerBuilder legato al documento specificato.
forDocument(key)DocumentTriggerBuilderCrea e restituisce un DocumentTriggerBuilder associato al documento con l'ID specificato.
forForm(form)FormTriggerBuilderCrea e restituisce un elemento FormTriggerBuilder collegato al modulo specificato.
forForm(key)FormTriggerBuilderCrea e restituisce un elemento FormTriggerBuilder collegato al modulo con l'ID specificato.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderCrea e restituisce un elemento SpreadsheetTriggerBuilder collegato al foglio di lavoro specificato.
forSpreadsheet(key)SpreadsheetTriggerBuilderCrea e restituisce un elemento SpreadsheetTriggerBuilder associato al foglio di lavoro con l'ID specificato.
forUserCalendar(emailId)CalendarTriggerBuilderRestituisce un generatore per la creazione di trigger di calendario.
timeBased()ClockTriggerBuilderCrea e restituisce un ClockTriggerBuilder per la creazione di trigger basati sul tempo.

Documentazione dettagliata

forDocument(document)

Crea e restituisce un elemento DocumentTriggerBuilder legato al documento specificato.

ScriptApp.newTrigger('myFunction')
  .forDocument(DocumentApp.getActiveDocument())
  .onOpen()
  .create();

Parametri

NomeTipoDescrizione
documentDocumentil documento

Ritorni

DocumentTriggerBuilder: il nuovo DocumentTriggerBuilder

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forDocument(key)

Crea e restituisce un DocumentTriggerBuilder associato al documento con l'ID specificato.

ScriptApp.newTrigger('myFunction')
  .forDocument('1234567890abcdefghijklmnopqrstuvwxyz')
  .onOpen()
  .create();

Parametri

NomeTipoDescrizione
keyStringl'ID del documento

Ritorni

DocumentTriggerBuilder: il nuovo DocumentTriggerBuilder

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forForm(form)

Crea e restituisce un elemento FormTriggerBuilder collegato al modulo specificato.

ScriptApp.newTrigger('myFunction')
  .forForm(FormApp.getActiveForm())
  .onFormSubmit()
  .create();

Parametri

NomeTipoDescrizione
formFormil modulo

Ritorni

FormTriggerBuilder: il nuovo FormTriggerBuilder

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forForm(key)

Crea e restituisce un elemento FormTriggerBuilder collegato al modulo con l'ID specificato.

ScriptApp.newTrigger('myFunction')
  .forForm('1234567890abcdefghijklmnopqrstuvwxyz')
  .onFormSubmit()
  .create();

Parametri

NomeTipoDescrizione
keyStringl'ID del modulo

Ritorni

FormTriggerBuilder: il nuovo FormTriggerBuilder

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forSpreadsheet(sheet)

Crea e restituisce un elemento SpreadsheetTriggerBuilder collegato al foglio di lavoro specificato.

ScriptApp.newTrigger('myFunction')
  .forSpreadsheet(SpreadsheetApp.getActive())
  .onEdit()
  .create();

Parametri

NomeTipoDescrizione
sheetSpreadsheetfoglio di lavoro

Ritorni

SpreadsheetTriggerBuilder: il nuovo FoglioTriggerBuilder

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forSpreadsheet(key)

Crea e restituisce un elemento SpreadsheetTriggerBuilder associato al foglio di lavoro con l'ID specificato.

ScriptApp.newTrigger('myFunction')
  .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz')
  .onEdit()
  .create();

Parametri

NomeTipoDescrizione
keyStringl'ID del foglio di lavoro

Ritorni

SpreadsheetTriggerBuilder: il nuovo FoglioTriggerBuilder

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forUserCalendar(emailId)

Restituisce un generatore per la creazione di trigger di calendario.

Parametri

NomeTipoDescrizione
emailIdStringID email del calendario utente monitorato dall'attivatore.

Ritorni

CalendarTriggerBuilder: il nuovo CalendarTriggerBuilder.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.readonly
  • https://www.google.com/calendar/feeds

timeBased()

Crea e restituisce un ClockTriggerBuilder per la creazione di trigger basati sul tempo.

ScriptApp.newTrigger('myFunction')
  .timeBased()
  .atDate(2013, 10, 31)
  .create();

Ritorni

ClockTriggerBuilder: il nuovo Quadrante TriggerBuilder

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/script.scriptapp