Class TriggerBuilder

Strumento per la creazione di trigger

Un generico generatore di trigger di script.

Metodi

Metodo	Tipo restituito	Breve descrizione
forDocument(document)	DocumentTriggerBuilder	Crea e restituisce un DocumentTriggerBuilder collegato al documento specificato.
forDocument(key)	DocumentTriggerBuilder	Crea e restituisce un DocumentTriggerBuilder collegato al documento con l'ID specificato.
forForm(form)	FormTriggerBuilder	Crea e restituisce un FormTriggerBuilder associato al modulo specificato.
forForm(key)	FormTriggerBuilder	Crea e restituisce un FormTriggerBuilder collegato al modulo con l'ID specificato.
forSpreadsheet(sheet)	SpreadsheetTriggerBuilder	Crea e restituisce un SpreadsheetTriggerBuilder collegato al foglio di lavoro specificato.
forSpreadsheet(key)	SpreadsheetTriggerBuilder	Crea e restituisce un oggetto SpreadsheetTriggerBuilder collegato al foglio di lavoro con l'ID specificato.
forUserCalendar(emailId)	CalendarTriggerBuilder	Restituisce un builder per la creazione di trigger di calendario.
timeBased()	ClockTriggerBuilder	Crea e restituisce un ClockTriggerBuilder per la creazione di trigger basati sul tempo.

Documentazione dettagliata

forDocument(document)

Crea e restituisce un DocumentTriggerBuilder collegato al documento specificato.

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

Parametri

Nome	Tipo	Descrizione
document	Document	Il documento.

Indietro

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 collegato al documento con l'ID specificato.

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

Parametri

Nome	Tipo	Descrizione
key	String	L'ID del documento.

Indietro

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 FormTriggerBuilder associato al modulo specificato.

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

Parametri

Nome	Tipo	Descrizione
form	Form	Il modulo.

Indietro

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 FormTriggerBuilder collegato al modulo con l'ID specificato.

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

Parametri

Nome	Tipo	Descrizione
key	String	L'ID del modulo.

Indietro

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 SpreadsheetTriggerBuilder collegato al foglio di lavoro specificato.

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

Parametri

Nome	Tipo	Descrizione
sheet	Spreadsheet	Il foglio di lavoro.

Indietro

SpreadsheetTriggerBuilder: il nuovo SpreadsheetTriggerBuilder.

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 oggetto SpreadsheetTriggerBuilder collegato al foglio di lavoro con l'ID specificato.

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

Parametri

Nome	Tipo	Descrizione
key	String	L'ID del foglio di lavoro.

Indietro

SpreadsheetTriggerBuilder: il nuovo SpreadsheetTriggerBuilder.

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 builder per la creazione di trigger di calendario.

Parametri

Nome	Tipo	Descrizione
emailId	String	ID email del calendario utente monitorato dal trigger.

Indietro

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();

Indietro

ClockTriggerBuilder: il nuovo ClockTriggerBuilder.

Autorizzazione

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

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