Class Trigger

  • getEventType() returns the type of event that causes the trigger to fire.

  • getHandlerFunction() returns the name of the script function that runs when the trigger fires.

  • getTriggerSource() identifies the origin of the event that activates the trigger.

  • getTriggerSourceId() provides an ID specific to the event source, like a spreadsheet ID.

  • getUniqueId() returns a unique identifier for the trigger itself.

Trigger

A script trigger.

Methods

MethodReturn typeBrief description
getEventType() EventType Returns the event type that the trigger fires on.
getHandlerFunction() StringReturns the function that will be called when the trigger fires.
getTriggerSource() TriggerSource Returns the source of events that will cause the trigger to fire.
getTriggerSourceId() StringReturns the id specific to the source.
getUniqueId() StringReturns a unique identifier that can be used to distinguish triggers from each other.

Detailed documentation

getEventType()

Returns the event type that the trigger fires on.

consttriggers=ScriptApp.getProjectTriggers();
for(leti=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
}
}

Return

EventType — the event type that this is a trigger for

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getHandlerFunction()

Returns the function that will be called when the trigger fires.

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

Return

String — the method name

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getTriggerSource()

Returns the source of events that will cause the trigger to fire.

For example, a spreadsheet onEdit trigger would return SPREADSHEETS, or a time based trigger would return CLOCK.

consttriggers=ScriptApp.getProjectTriggers();
for(leti=0;i < triggers.length;i++){
if(triggers[i].getTriggerSource()===ScriptApp.TriggerSource.CLOCK){
Logger.log(`${triggers[i].getUniqueId()} source is clock`);
}elseif(
triggers[i].getTriggerSource()===ScriptApp.TriggerSource.SPREADSHEETS){
Logger.log(`${triggers[i].getUniqueId()} source is spreadsheets`);
}
}

Return

TriggerSource — the publisher this is a trigger for

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getTriggerSourceId()

Returns the id specific to the source.

For example, if the trigger source is a spreadsheet, this would be the id of the spreadsheet. For clock events this returns null.

Return

String — the id of the entity in the publisher that this is a trigger for

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

getUniqueId()

Returns a unique identifier that can be used to distinguish triggers from each other.

Return

String — the unique identifier of the trigger

Authorization

Scripts that use this method require authorization with one or more of the following scopes:

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

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024年12月03日 UTC.