Class Trigger

ทริกเกอร์

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

เมธอด

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

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

getEventType()

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

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

รีเทิร์น

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 

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`);
  }
}

รีเทิร์น

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