Google表單自動寄信給填表人

2013/09/15 updated: 由於sheet的API呼叫跟Form的呼叫API不同，這邊加入Google表單的範例。
2015/02/27 updated: Google Docs的API改版了，筆者已經發布新版的寫法，請移駕至此。

現在網路上教的Google Docs問卷，都只有填表格功能，難道沒有讓使用者填寫完資料後，寄一份資料到使用者信箱的功能嗎？因為我們有時候需要製作收據系統之類的…。

答案是有的！我們只要動幾根手指頭，依照下列步驟，就可以輕易開發出這個功能喔！請依照以下步驟一步一步跟著我做即可。
請注意，如果是直接用Google表單的話，請注意第三步驟有些不同。

開發步驟
Step 1. 先開啟Google試算表。

Step 2. 假設我的表單只有兩個欄位：姓名與Mail。按上方工具列，選擇工具→表單→編輯表格，先建立表單內容，然後按下存檔。

Step 3. 回到Google表格編輯頁，這次請選擇工具→指令碼編輯器，出現程式碼視窗後，輸入下列程式碼，如圖 2 (標題與內容請自行修改)，這邊有Google試算表跟表單兩種不同API實現方式，請注意一開始是使用Google表單還是試算表製作：

(Google試算表版本)

	function sendMails(e) {
	// 獲取時間戳記
	var timestamp = e.values[0];
	// 得到第一個欄位的值，在這個範例中，我們可取得「姓名」。
	var name = e.values[1];
	// 得到第二個欄位的值，在這個範例中，我們可取得「EMail位址」。
	var mail = e.values[2];
	/* 設定寄件內容，Mail.App.sendEMail()這個函式，
	第一個參數為「EMail位址」，第二個參數為「標題」，第三個參數為「內容」。
	以這個範例而言，我設定標題為 "表單測試: 使用者名稱"，內容為"姓名:xxx submitted by Allen"
	*/
	MailApp.sendEmail(mail, "表單測試："+name,
	"姓名：" + name + " submitted by Allen.");
	}

view raw Google表單自動寄信Script.js hosted with ❤ by GitHub

(Google表單版本)

	/* Gogole Form 專用發送EMail程序 */
	function sendMails(e) {
	// 取得使用者送出的資料(陣列)
	var currentItemResponses = e.response.getItemResponses();
	// 注意，每一筆array entry用來表示每個表單的問題與答案。
	// 在本範例中，第一個entry是姓名(index 0)，第二個entry是EMail (index 1)。
	// 我們使用getItem可以獲得提問的問題選項物件，getResponse則是取得該問題的輸入答案。
	// 例如index 0的提問選項為「使用者姓名」，而輸入的答案為「Allen」。則可以用以下語法獲得所需資料。
	// Logger.log("Question %s = %s", currentItemResponses[0].getItem().getTitle(), currentItemResponses[0].getResponse());
	// 取得姓名輸入資料
	var userName = currentItemResponses[0].getResponse();
	// 取得EMail輸入資料
	var userEMail = currentItemResponses[1].getResponse();
	/* 設定寄件內容，Mail.App.sendEMail()這個函式，
	第一個參數為「EMail位址」，第二個參數為「標題」，第三個參數為「內容」。
	以這個範例而言，我設定標題為 "表單測試: 使用者名稱"，內容為"姓名:xxx submitted by Allen"
	*/
	MailApp.sendEmail(userEMail, "表單測試："+ userName,
	"姓名：" + userName + " submitted by Allen.");
	}

view raw NewGoogleFormSubmitEmail.js hosted with ❤ by GitHub

Step 4. 接著在工具列上面，選擇”觸發器”→現有指令碼的觸發程序

Step 5. 由於現在都沒有加入任何觸發器，因此我們可加入一個新的。

(1) 請點選”Add a new trigger”連結

(2) 設定執行的函式為sendMails，Events 來源為From spreadsheet，動作為On form submit，然後儲存關閉。

這樣子就大功告成了！

實際測試

Step 1. 先進入即時表格，輸入內容，按下送出。

Step 2. 系統會提醒你回應訊息。
(回應訊息可在編輯表單時，右上方功能列的更多動作→編輯確認訊息 自訂)

Step 3. 請到您的信箱確認！沒錯，訊息已經收到囉。

註：沒想到這篇Post完沒多久，才發現已經有人寫好App可以安裝了。
         http://disp.cc/b/3-2oPJ
        沒關係！多學會一點，就多一項技能！

參考資料

1. Google試算表與Google App Script的自動化應用 http://www.cc.ntu.edu.tw/chinese/epaper/0019/20111220_1906.html

2. Google Apps Script: Running Scripts in Response to an Event

http://code.google.com/intl/zh-TW/googleapps/appsscript/guide_events.html
3. Google FormResponse
https://developers.google.com/apps-script/reference/forms/form-response