Class Trigger

ทริกเกอร์

ทริกเกอร์สคริปต์

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getEventType()EventTypeแสดงผลประเภทเหตุการณ์ที่ทริกเกอร์เริ่มทำงาน
getHandlerFunction()Stringแสดงผลฟังก์ชันที่จะถูกเรียกเมื่อทริกเกอร์เริ่มทำงาน
getTriggerSource()TriggerSourceแสดงผลแหล่งที่มาของเหตุการณ์ที่จะทำให้ทริกเกอร์เริ่มทำงาน
getTriggerSourceId()Stringแสดงผลรหัสเฉพาะของแหล่งที่มา
getUniqueId()Stringแสดงผลตัวระบุที่ไม่ซ้ำกันที่ใช้เพื่อแยกทริกเกอร์ออกจากกันได้

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

getEventType()

แสดงผลประเภทเหตุการณ์ที่ทริกเกอร์เริ่มทำงาน 

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

รีเทิร์น

EventType — ประเภทเหตุการณ์ที่เป็นตัวทริกเกอร์นี้

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

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

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

getHandlerFunction()

แสดงผลฟังก์ชันที่จะถูกเรียกเมื่อทริกเกอร์เริ่มทำงาน 

// Create a trigger for the script.
ScriptApp.newTrigger('myFunction').forSpreadsheet('id of my spreadsheet').onEdit().create();
Logger.log(ScriptApp.getProjectTriggers()[0].getHandlerFunction()); // logs "myFunction"

รีเทิร์น

String — ชื่อเมธอด

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

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

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

getTriggerSource()

แสดงผลแหล่งที่มาของเหตุการณ์ที่จะทำให้ทริกเกอร์เริ่มทำงาน

ตัวอย่างเช่น ทริกเกอร์สเปรดชีต onEdit จะแสดงผล SPREADSHEETS หรือทริกเกอร์ตามเวลา จะแสดงผล 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");
  }
}

รีเทิร์น

TriggerSource — ผู้เผยแพร่โฆษณาที่เป็นผู้ทริกเกอร์

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

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

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

getTriggerSourceId()

แสดงผลรหัสเฉพาะของแหล่งที่มา

ตัวอย่างเช่น หากแหล่งที่มาของทริกเกอร์เป็นสเปรดชีต นี่จะเป็นรหัสของ สเปรดชีต สำหรับเหตุการณ์นาฬิกา ค่านี้จะเป็น Null

รีเทิร์น

String — รหัสของเอนทิตีในผู้เผยแพร่โฆษณาที่เป็นทริกเกอร์

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

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

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

getUniqueId()

แสดงผลตัวระบุที่ไม่ซ้ำกันที่ใช้เพื่อแยกทริกเกอร์ออกจากกันได้

รีเทิร์น

String — ตัวระบุที่ไม่ซ้ำกันของทริกเกอร์

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

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

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