Class Trigger

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

Trình kích hoạt tập lệnh.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getEventType()EventTypeTrả về loại sự kiện mà trình kích hoạt kích hoạt.
getHandlerFunction()StringTrả về hàm sẽ được gọi khi trình kích hoạt kích hoạt.
getTriggerSource()TriggerSourceTrả về nguồn sự kiện sẽ khiến trình kích hoạt kích hoạt.
getTriggerSourceId()StringTrả về mã nhận dạng riêng của nguồn.
getUniqueId()StringTrả về một giá trị nhận dạng duy nhất có thể dùng để phân biệt trình 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.

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 cần được uỷ 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 trình 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 cần được uỷ 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 sự kiện sẽ khiến trình kích hoạt kích hoạt.

Ví dụ: điều kiện kích hoạt onEdit trên 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.

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 dùng để kích hoạt thao tác này

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ 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 riêng của nguồn.

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

Cầu thủ trả bóng

String – mã nhận dạng của thực thể trong nhà xuất bản được dùng 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 cần được uỷ 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 trình kích hoạt với nhau.

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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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