Class Trigger

Điều kiện kích hoạt

Một hàm kích hoạt tập lệnh.

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
getEventType()	EventType	Trả về loại sự kiện mà trình kích hoạt kích hoạt.
getHandlerFunction()	String	Trả về hàm được gọi khi điều kiện kích hoạt hoạt động.
getTriggerSource()	TriggerSource	Trả về nguồn của các sự kiện khiến trình kích hoạt hoạt động.
getTriggerSourceId()	String	Trả về mã nhận dạng dành riêng cho nguồn.
getUniqueId()	String	Trả về một giá trị nhận dạng riêng biệt có thể dùng để phân biệt các điều kiện kích hoạt với nhau.

Tài liệu chi tiết

getEventType()

Trả về loại sự kiện mà trình kích hoạt kích hoạt.

const triggers = ScriptApp.getProjectTriggers();
for (let 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

getHandlerFunction()

Trả về hàm được gọi khi điều kiện kích hoạt hoạt động.

// 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

getTriggerSource()

Trả về nguồn của các sự kiện khiến trình kích hoạt hoạt động.

Ví dụ: trình kích hoạt onEdit của bảng tính sẽ trả về SPREADSHEETS hoặc trình kích hoạt dựa trên thời gian sẽ trả về CLOCK.

const triggers = ScriptApp.getProjectTriggers();
for (let 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 mà điều kiện này kích hoạt.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

getTriggerSourceId()

Trả về mã nhận dạng dành riêng cho nguồn.

Ví dụ: nếu nguồn kích hoạt là một bảng tính, thì đây là mã nhận dạng của bảng tính đó. Đối với các sự kiện đồng hồ, hàm này sẽ trả về null.

Cầu thủ trả bóng

String – Mã nhận dạng của thực thể trong nhà xuất bản mà đây là điều kiện kích hoạt.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

getUniqueId()

Trả về một giá trị nhận dạng riêng biệt có thể dùng để phân biệt các điều kiện kích hoạt với nhau.

Cầu thủ trả bóng

String – Giá trị nhận dạng riêng biệt của điều kiện kích hoạt.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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