編輯器與第一支腳本
Apps Script 編輯器是瀏覽器裡的開發環境：寫函式、按執行、看執行紀錄。第一次接觸請從 Google 試算表 進去，因為畫面與權限最直觀。
從試算表打開
- 開一份新的或既有的 Google 試算表。
- 選單 擴充功能 → Apps Script。
- 新分頁會出現專案，預設有
Code.gs與空的myFunction。
編輯器左側是檔案與函式清單，中間是程式，上方有儲存、執行、偵錯。右側「執行」分頁會顯示 Logger.log 與錯誤。
寫第一支函式
把預設內容換成：
function sayHello() {
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A1").setValue("Hello, Apps Script");
Logger.log("已寫入 A1");
}
- 按儲存（或 Ctrl+S）。
- 在函式下拉選
sayHello，按 執行。 - 第一次會跳出「授權」，選自己的 Google 帳號，必要時點「進階 → 前往（不安全）」——這是自家專案尚未通過 Google 審查時的正常畫面，不是病毒。
- 回到試算表，A1 應出現文字；編輯器執行紀錄會有
已寫入 A1。
SpreadsheetApp 是試算表服務的入口。getActiveSheet() 只在繫結在這份試算表的腳本裡有意義；獨立專案要用 ID 開啟，見 專案類型。
編輯器裡還會用到的東西
| 位置 | 用途 |
|---|---|
| 執行紀錄 | 每次跑函式的成功／失敗與 Logger.log |
| 觸發條件（時鐘圖示） | 新增時間驅動或表單提交等可安裝觸發，見 觸發條件 |
| 專案設定 | 時區、指令碼 ID、Google Cloud 專案編號 |
| 服務（+） | 加入進階 Google API，例如 YouTube Data、Drive API v3 |
| 程式庫 | 引用別人發佈的 Apps Script 程式庫 |
除錯可用編輯器的偵錯鈕設中斷點，或到處加 Logger.log。console.log 在 V8 執行階段也能寫進執行紀錄。
不要把密鑰寫死在程式裡
API 金鑰、服務帳戶 JSON 請放 專案設定 → 指令碼屬性，用 PropertiesService.getScriptProperties() 讀取。程式會進版本歷史，明文密鑰很容易外流。
下一步：分清楚繫結與獨立專案。畫面示範可看 YouTube 優質教學 的入門片。