iT邦幫忙

2021 iThome 鐵人賽

DAY 6
0
IT管理

「Google Apps Script」 學習筆記系列 第 6

【Day 6】Google Apps Script - 觸發條件與簡單觸發器(Simple Triggers)

掌握觸發條件的設定與簡單觸發器的保留函式,讓你的 Apps Script 裡的函式自動被觸發執行。


今日要點:
》觸發條件設定
》介紹簡單觸發器


觸發條件

假如我們想讓一個 function 每分鐘自動執行一次.

我們先點選左邊第三個功能觸發條件(時鐘圖示),點選右下的「新增觸發條件」

這時候就會跳出選單讓你設定

紅色字是我們範例選定的選項
選擇您要執行的功能funcDemo_SimpleTriggers,這裡會列出專案裡的 function 讓你選擇
選擇應執行的部署作業上端
選取活動來源:(時間驅動 / 來自日曆)
選取時間型觸發條件類型

  • 「特定日期時間」 日期時間:(YYYY-MM-DD HH:MM)
  • 分鐘計時器」 間隔:( 每分鐘 / 每5分鐘 / 每10分鐘 / 每15分鐘 / 每30分鐘 )
  • 「小時計時器」 間隔:( 每小時 / 每2小時 / 每4小時 / 每6小時 / 每8小時 / 每12小時 )
  • 「日計時器」 時段:( 午夜到上午1點 / ... / 晚上11點到午夜 )
  • 「周計時器」 星期:( 星期一 / ... / 星期日 ) 時段:( 午夜到上午1點 / ... / 晚上11點到午夜 )
  • 「月計時器」 日期:( 1日 / ... / 31日 ) 時段:( 午夜到上午1點 / ... / 晚上11點到午夜 )

完成後就可以看到專案裡多出一個觸發條件

之後每分鐘都可以看到他被執行了一次

也可以把原本設定好的觸發條件刪除

會再確認一次是否刪除

除了我們設定一些觸發條件外,Apps Script 裡也有一些預設的保留函數觸發器,可讓 Apps Script 在發生特定事件(例如打開文檔)時自動運行函數。

簡單觸發器(Simple Triggers)

簡單觸發器是一組內置於 Apps Script 中的保留函數,例如很多應用場景都會用到的 doGet(e) 和 doPost(e)。或是在開啟檔案時觸發的 onOpen(e),可以在這時候在工具列上加入一個自定選單。

手冊裡列出的保留函數有

保留函數 觸發條件說明
doGet(e) 在用戶訪問 Web 應用程序或程序向 Web 應用程序發送 HTTP GET 請求時運行。
doPost(e) 在程序向 Web 應用程序發送 HTTP POST 請求時運行。
onOpen(e) 在用戶打開用戶有編輯權限的電子表格、文檔、簡報或表單時運行。
onInstall(e) 在用戶從 Google 文檔、表格、簡報或表單中安裝 add-on 時運行。
onEdit(e) 在用戶更改電子表格中的值時運行。
onSelectionChange(e) 在用戶更改電子表格中的選擇時運行。

掌握以上觸發條件的設定與簡單觸發器的保留函式,可讓你的 Apps Script 裡的函式在指定的條件下與特定的場景下自動觸發執行函數,讓函式自動化回應與處理,應用更加便利。

參考


上一篇
【Day 5】Google Apps Script - 變數與函式呼叫與GS檔的順序影響
下一篇
【Day 7】Google Apps Script - 使用 Google Docs 撰寫 Demo 用的 API 文件
系列文
「Google Apps Script」 學習筆記30

尚未有邦友留言

立即登入留言