Class TriggerBuilder

Trình tạo trình kích hoạt

Trình tạo chung cho các trình kích hoạt tập lệnh.

Phương pháp

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
forDocument(document)	DocumentTriggerBuilder	Tạo và trả về DocumentTriggerBuilder liên kết với tài liệu đã cho.
forDocument(key)	DocumentTriggerBuilder	Tạo và trả về DocumentTriggerBuilder liên kết với tài liệu có mã nhận dạng nhất định.
forForm(form)	FormTriggerBuilder	Tạo và trả về FormTriggerBuilder liên kết với biểu mẫu đã cho.
forForm(key)	FormTriggerBuilder	Tạo và trả về FormTriggerBuilder liên kết với biểu mẫu có mã nhận dạng nhất định.
forSpreadsheet(sheet)	SpreadsheetTriggerBuilder	Tạo và trả về SpreadsheetTriggerBuilder liên kết với bảng tính đã cho.
forSpreadsheet(key)	SpreadsheetTriggerBuilder	Tạo và trả về SpreadsheetTriggerBuilder liên kết với bảng tính có mã nhận dạng đã cho.
forUserCalendar(emailId)	CalendarTriggerBuilder	Trả về trình tạo để tạo trình kích hoạt lịch.
timeBased()	ClockTriggerBuilder	Tạo và trả về ClockTriggerBuilder để tạo các trình kích hoạt dựa trên thời gian.

Tài liệu chi tiết

forDocument(document)

Tạo và trả về DocumentTriggerBuilder liên kết với tài liệu đã cho.

ScriptApp.newTrigger('myFunction')
  .forDocument(DocumentApp.getActiveDocument())
  .onOpen()
  .create();

Các tham số

Tên	Loại	Mô tả
document	Document	tài liệu

Hai chiều

DocumentTriggerBuilder – Tài liệu kích hoạt mới cho DocumentActivateBuilder

Ủy quyền

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

---

forDocument(key)

Tạo và trả về DocumentTriggerBuilder liên kết với tài liệu có mã nhận dạng nhất định.

ScriptApp.newTrigger('myFunction')
  .forDocument('1234567890abcdefghijklmnopqrstuvwxyz')
  .onOpen()
  .create();

Các tham số

Tên	Loại	Mô tả
key	String	mã nhận dạng cho tài liệu

Hai chiều

DocumentTriggerBuilder – Tài liệu kích hoạt mới cho DocumentActivateBuilder

Ủy quyền

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

---

forForm(form)

Tạo và trả về FormTriggerBuilder liên kết với biểu mẫu đã cho.

ScriptApp.newTrigger('myFunction')
  .forForm(FormApp.getActiveForm())
  .onFormSubmit()
  .create();

Các tham số

Tên	Loại	Mô tả
form	Form	biểu mẫu

Hai chiều

FormTriggerBuilder – FormTriggerBuilder mới

Ủy quyền

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

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

forForm(key)

Tạo và trả về FormTriggerBuilder liên kết với biểu mẫu có mã nhận dạng nhất định.

ScriptApp.newTrigger('myFunction')
  .forForm('1234567890abcdefghijklmnopqrstuvwxyz')
  .onFormSubmit()
  .create();

Các tham số

Tên	Loại	Mô tả
key	String	mã nhận dạng của biểu mẫu

Hai chiều

FormTriggerBuilder – FormTriggerBuilder mới

Ủy quyền

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

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

forSpreadsheet(sheet)

Tạo và trả về SpreadsheetTriggerBuilder liên kết với bảng tính đã cho.

ScriptApp.newTrigger('myFunction')
  .forSpreadsheet(SpreadsheetApp.getActive())
  .onEdit()
  .create();

Các tham số

Tên	Loại	Mô tả
sheet	Spreadsheet	bảng tính

Hai chiều

SpreadsheetTriggerBuilder – Bảng kích hoạt mới

Ủy quyền

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

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

forSpreadsheet(key)

Tạo và trả về SpreadsheetTriggerBuilder liên kết với bảng tính có mã nhận dạng đã cho.

ScriptApp.newTrigger('myFunction')
  .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz')
  .onEdit()
  .create();

Các tham số

Tên	Loại	Mô tả
key	String	Mã nhận dạng cho bảng tính

Hai chiều

SpreadsheetTriggerBuilder – Bảng kích hoạt mới

Ủy quyền

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

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

forUserCalendar(emailId)

Trả về trình tạo để tạo trình kích hoạt lịch.

Các tham số

Tên	Loại	Mô tả
emailId	String	mã email của lịch người dùng mà trình kích hoạt giám sát.

Hai chiều

CalendarTriggerBuilder – Trình kích hoạt CalendarCalendarBuilder mới.

Ủy quyền

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

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.googleapis.com/auth/calendar.events
• https://www.googleapis.com/auth/calendar.events.readonly
• https://www.google.com/calendar/feeds

---

timeBased()

Tạo và trả về ClockTriggerBuilder để tạo các trình kích hoạt dựa trên thời gian.

ScriptApp.newTrigger('myFunction')
  .timeBased()
  .atDate(2013, 10, 31)
  .create();

Hai chiều

ClockTriggerBuilder – Trình kích hoạt xung nhịp mới

Ủy quyền

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

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