Trang này được dịch bởi Cloud Translation API.

Class Trigger

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à trình kích hoạt kích hoạt.
`getHandlerFunction()`	`String`	Trả về hàm sẽ được gọi khi điều kiện kích hoạt được kích hoạt.
`getTriggerSource()`	`TriggerSource`	Trả về nguồn sự kiện sẽ kích hoạt điều kiện kích hoạt.
`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 duy nhất có thể dùng để phân biệt các 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à điều kiện kích hoạt sẽ 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à điều nà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 yêu cầu đượ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 điều kiện kích hoạt được 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ẽ kích hoạt điều kiện kích hoạt.

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 kích hoạt này dành cho

Ủy quyền

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

Ví dụ: nếu nguồn đ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 sẽ 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 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 yêu cầu đượ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 các 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

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

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