Class TriggerBuilder

เครื่องมือสร้างทริกเกอร์

ตัวสร้างทั่วไปสำหรับทริกเกอร์สคริปต์

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
forDocument(document)DocumentTriggerBuilderสร้างและแสดงผล DocumentTriggerBuilder ที่เชื่อมโยงกับเอกสารที่ระบุ
forDocument(key)DocumentTriggerBuilderสร้างและแสดงผล DocumentTriggerBuilder ที่เชื่อมโยงกับเอกสารที่มีรหัสที่ระบุ
forForm(form)FormTriggerBuilderสร้างและแสดงผล FormTriggerBuilder ที่เชื่อมโยงกับแบบฟอร์มที่ระบุ
forForm(key)FormTriggerBuilderสร้างและแสดงผล FormTriggerBuilder ที่เชื่อมโยงกับแบบฟอร์มที่มีรหัสที่ระบุ
forSpreadsheet(sheet)SpreadsheetTriggerBuilderสร้างและแสดงผล SpreadsheetTriggerBuilder ที่เชื่อมโยงกับสเปรดชีตที่ระบุ
forSpreadsheet(key)SpreadsheetTriggerBuilderสร้างและแสดงผล SpreadsheetTriggerBuilder ที่เชื่อมโยงกับสเปรดชีตที่มีรหัสที่ระบุ
forUserCalendar(emailId)CalendarTriggerBuilderแสดงผลเครื่องมือสร้างสำหรับสร้างทริกเกอร์ปฏิทิน
timeBased()ClockTriggerBuilderสร้างและแสดงผล ClockTriggerBuilder สำหรับการสร้างทริกเกอร์ตามเวลา

เอกสารประกอบโดยละเอียด

forDocument(document)

สร้างและแสดงผล DocumentTriggerBuilder ที่เชื่อมโยงกับเอกสารที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
documentDocumentเอกสาร

รีเทิร์น

DocumentTriggerBuilder — DocumentTriggerBuilder ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

forDocument(key)

สร้างและแสดงผล DocumentTriggerBuilder ที่เชื่อมโยงกับเอกสารที่มีรหัสที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
keyStringรหัสของเอกสาร

รีเทิร์น

DocumentTriggerBuilder — DocumentTriggerBuilder ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

forForm(form)

สร้างและแสดงผล FormTriggerBuilder ที่เชื่อมโยงกับแบบฟอร์มที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formFormแบบฟอร์ม

รีเทิร์น

FormTriggerBuilder — FormTriggerBuilder ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

forForm(key)

สร้างและแสดงผล FormTriggerBuilder ที่เชื่อมโยงกับแบบฟอร์มที่มีรหัสที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
keyStringรหัสของแบบฟอร์ม

รีเทิร์น

FormTriggerBuilder — FormTriggerBuilder ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

forSpreadsheet(sheet)

สร้างและแสดงผล SpreadsheetTriggerBuilder ที่เชื่อมโยงกับสเปรดชีตที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sheetSpreadsheetสเปรดชีต

รีเทิร์น

SpreadsheetTriggerBuilder — SpreadsheetTriggerBuilder ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

forSpreadsheet(key)

สร้างและแสดงผล SpreadsheetTriggerBuilder ที่เชื่อมโยงกับสเปรดชีตที่มีรหัสที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
keyStringรหัสสเปรดชีต

รีเทิร์น

SpreadsheetTriggerBuilder — SpreadsheetTriggerBuilder ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

forUserCalendar(emailId)

แสดงผลเครื่องมือสร้างสำหรับสร้างทริกเกอร์ปฏิทิน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailIdStringรหัสอีเมลของปฏิทินของผู้ใช้ที่ทริกเกอร์ตรวจสอบ

รีเทิร์น

CalendarTriggerBuilder — CalendarTriggerBuilder ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • 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()

สร้างและแสดงผล ClockTriggerBuilder สำหรับการสร้างทริกเกอร์ตามเวลา 

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

รีเทิร์น

ClockTriggerBuilder — ClockTriggerBuilder ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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