脚本触发器。
方法
方法 | 返回类型 | 简介 |
---|---|---|
getEventType() | EventType | 返回触发器触发的事件类型。 |
getHandlerFunction() | String | 返回将在触发器触发时调用的函数。 |
getTriggerSource() | TriggerSource | 返回导致触发器触发的事件的来源。 |
getTriggerSourceId() | String | 返回来源特定的 ID。 |
getUniqueId() | String | 返回可用于区分不同触发器的唯一标识符。 |
详细文档
getEventType()
返回触发器触发的事件类型。
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 } }
弃踢回攻
EventType
- 表示此触发器的事件类型
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.scriptapp
getHandlerFunction()
返回将在触发器触发时调用的函数。
// Create a trigger for the script. ScriptApp.newTrigger('myFunction').forSpreadsheet('id of my spreadsheet').onEdit().create(); Logger.log(ScriptApp.getProjectTriggers()[0].getHandlerFunction()); // logs "myFunction"
弃踢回攻
String
- 方法名称
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.scriptapp
getTriggerSource()
返回将触发触发器的事件的来源。
例如,电子表格 onEdit 触发器将返回 SPREADSHEETS 项,或者基于时间的触发器将返回 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"); } }
弃踢回攻
TriggerSource
- 作为触发条件的发布商
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.scriptapp
getTriggerSourceId()
返回来源的专属 ID。
例如,如果触发器来源是电子表格,则此值为电子表格的 ID。对于时钟事件,这将返回 null。
弃踢回攻
String
- 用作触发器的发布商中实体的 ID
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.scriptapp
getUniqueId()
返回可用于区分不同触发器的唯一标识符。
弃踢回攻
String
- 触发器的唯一标识符
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.scriptapp