Một điều kiện kích hoạt tập lệnh.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
getEventType() | EventType | Trả về loại sự kiện mà điều kiện kích hoạt sẽ kích hoạt. |
getHandlerFunction() | String | Trả về hàm sẽ được gọi khi điều kiện kích hoạt kích hoạt. |
getTriggerSource() | TriggerSource | Trả về nguồn của sự kiện sẽ khiến trình kích hoạt kích hoạt. |
getTriggerSourceId() | String | Trả về mã nhận dạng cụ thể cho nguồn. |
getUniqueId() | String | Trả về một giá trị nhận dạng duy nhất có thể dùng để phân biệt các điều kiện kích hoạt. |
Tài liệu chi tiết
getEventType()
Trả về loại sự kiện mà điều kiện kích hoạt sẽ kích hoạt.
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 } }
Cầu thủ trả bóng
EventType
– loại sự kiện mà đây là điều kiện kích hoạt
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/script.scriptapp
getHandlerFunction()
Trả về hàm sẽ được gọi khi điều kiện kích hoạt kích hoạt.
// Create a trigger for the script. ScriptApp.newTrigger('myFunction').forSpreadsheet('id of my spreadsheet').onEdit().create(); Logger.log(ScriptApp.getProjectTriggers()[0].getHandlerFunction()); // logs "myFunction"
Cầu thủ trả bóng
String
– tên phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/script.scriptapp
getTriggerSource()
Trả về nguồn của sự kiện sẽ khiến trình kích hoạt kích hoạt.
Ví dụ: một điều kiện kích hoạt onEdit trong bảng tính sẽ trả về SPREADSHEETS hoặc một điều kiện kích hoạt dựa trên thời gian sẽ trả về 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"); } }
Cầu thủ trả bóng
TriggerSource
– nhà xuất bản này là điều kiện kích hoạt cho
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/script.scriptapp
getTriggerSourceId()
Trả về mã nhận dạng cụ thể cho nguồn.
Ví dụ: nếu nguồn trình kích hoạt là một bảng tính, đây sẽ là mã của bảng tính. Đối với các sự kiện đồng hồ, giá trị này sẽ trả về giá trị rỗng.
Cầu thủ trả bóng
String
— mã của thực thể trong nhà xuất bản mà đây là điều kiện kích hoạt cho
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/script.scriptapp
getUniqueId()
Trả về một giá trị nhận dạng duy nhất có thể dùng để phân biệt các điều kiện kích hoạt.
Cầu thủ trả bóng
String
– giá trị nhận dạng duy nhất của điều kiện kích hoạt
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/script.scriptapp