如果你常在開 Google 試算表，大概對那幾個步驟很熟：按「新增」、改名字、搬到正確資料夾、設欄位格式、再把同事拉進來。

麻煩的是，每次都要重來一遍，還常被時區、日期、權限這些小東西絆腳。

本篇文章盡可能將內容說清楚、做簡單：先用最直覺的方法把第一份表穩穩生出來，再用 Apps Script 的 SpreadsheetApp.create() 把「建立→初始化→搬移→加權限」整串自動化。

文中給你能直接貼上的程式碼、一步步操作，以及容易踩雷的清單（共享雲端硬碟權限、配額與逾時、日期跑偏等），希望本篇文章能幫助到你。

function bootstrapReport(title, folderId, editors) {
const ss = SpreadsheetApp.create(title, 1000, 20);
// 移動到指定資料夾
DriveApp.getFileById(ss.getId()).moveTo(DriveApp.getFolderById(folderId));


// Sheet 結構
const raw = ss.getActiveSheet().setName('原始資料');
const meta = ss.insertSheet('維護');


raw.getRange(1,1,1,8).setValues([[
'日期','部門','負責人','客戶','品項','數量','單價','小計'
]]).setFontWeight('bold');
raw.getRange('H2').setFormula('=E2*F2');


// 基本格式
raw.getRange('A:A').setNumberFormat('yyyy-mm-dd');
raw.getRange('F:F').setNumberFormat('#,##0');
raw.getRange('G:H').setNumberFormat('#,##0.00');


// 保護（鎖欄）
const p = raw.getRange('A1:H1').protect();
p.setDescription('鎖定標頭');
p.removeEditors(p.getEditors());


// 權限（加編輯者）
editors.forEach(mail => ss.addEditor(mail));


return ss.getUrl();
}

TIP：初始化時一次把欄位、格式、保護、權限都設定好，能省下大量手動維護成本。

共用與權限模型：個人硬碟 vs. 共享雲端硬碟

1. 個人我的雲端硬碟：檔案屬於建立者；搬到資料夾後，繼承資料夾權限。

2. 共享雲端硬碟：檔案屬於團隊；moveTo() 需有該共享雲端硬碟的「內容管理者」以上權限，否則會丟例外。

建議：

先建立在個人硬碟，再搬移到共享雲端硬碟測試權限；或直接用模板已在共享雲端硬碟建立。

配額與限制（量產前必讀）

Apps Script 單次執行時間上限（常見為 6 分鐘）；大量建檔請分批或用排程分段跑。

每日配額：

讀寫、建立檔案、寄信、觸發器總執行量等都有上限；量大時須做節流與重試。

節流建議：

1. 批次處理：把多個 setValue 合併成一次 setValues；格式一次性套用區域。

2. 加入 sleep/backoff：遇到 Service invoked too many times 時，退避 2^n 秒再重試。

3. 利用時間驅動觸發器（每 5~15 分鐘）分段建立，降低單次壓力。

常見錯誤與雷點（含排錯建議）

症狀／訊息	典型成因	快速排查與修法
`Service invoked too many times`	建檔/寫入過於頻繁，打到配額	加入退避重試；分批；避開整點；減少 API 呼叫次數
`Exception: You do not have permission`	權限不足（尤其搬往共享雲端硬碟）	確認對目標共享雲端硬碟有「內容管理者」；或改放到個人資料夾後由管理者搬
建立成功但找不到檔案	建在根目錄沒搬移、或搬到你無權限的空間	立即 Log `getUrl()` 與 `getId()`；把搬移失敗也記錄並重試
日期/金額格式怪	語系或時區不一致	統一 `zh_TW` 與時區；模板化設定；用 `TEXT()` 明確格式化
標頭/驗證規則被改壞	權限太鬆、未設保護	鎖標頭列；把維護設定放到獨立工作表並保護
每月自動建檔偶爾漏跑	觸發器尖峰或短暫失敗	觸發器多設幾個分流時點；腳本內部加重試與錯誤通知
跨時區同事看到不同日期	使用者個人設定不同	用固定時區格式化（`Utilities.formatDate`）；在文件設定統一時區