GAS 是什麼？

💬

✅ 透過 Webhook 網址傳送訊息

✅ 支援 Card 格式（按鈕、圖片、表格）

✅ 免費，學校 Google Workspace 直接用

✅ 可發送到指定 Space 或個人

🟢

✅ 透過 Messaging API 傳送訊息

✅ 支援 Flex Message（高度客製化）

✅ 可推播給個人或群組

✅ 家長、老師幾乎人人都有

清除儲存格內容

// 清除值但保留格式
sheet.getRange("A1:C10").clearContent();

// 全部清除（含格式）
sheet.getRange("A1:C10").clear();

搜尋特定值

const data = sheet.getDataRange().getValues();
const found = data.find(row => row[0] === "王小明");
Logger.log(found);

getDataRange — 自動抓全部資料

// 不用指定範圍，自動抓有資料的區域
const all = sheet.getDataRange().getValues();

// 跳過標題列（第一行）
const rows = all.slice(1);

💡 效能提醒
盡量用 getValues() 一次讀取，避免在迴圈裡重複呼叫 getValue()，會大幅拖慢速度！

📋 任務一：遮蔽姓名

把姓名中間那個字替換成「○」，保護個資但仍可辨識

🔧 任務二：建立工具列

在 Google 試算表頂端選單新增一個「自訂工具列」，讓老師直接點選按鈕就能執行程式，不需要進 GAS 編輯器

📊 試算表範例結構

💡 A欄放原始姓名，C欄用GAS自動寫入遮蔽後的結果

// 遮蔽 A 欄姓名，結果寫入 C 欄
function maskNames() {
 const sheet = SpreadsheetApp
  .getActiveSpreadsheet().getActiveSheet();
 const lastRow = sheet.getLastRow();
 const names = sheet
  .getRange(2, 1, lastRow-1, 1).getValues();

 const masked = names.map(row => {
  const name = row[0];
  if (name.length < 2) return [name];
  const result =
   name[0] + '○' + name.slice(2);
  return [result];
 });

 // 寫入 C 欄（從第2列起）
 sheet.getRange(2, 3, masked.length, 1)
  .setValues(masked);
 SpreadsheetApp.getUi().alert('✅ 完成！');
}

// 開啟試算表時自動建立選單
function onOpen() {
 SpreadsheetApp.getUi()
  .createMenu('🔧 我的工具')
  .addItem('遮蔽姓名中間字', 'maskNames')
  .addToUi();
}

name[0] 取第1個字（姓）

name.slice(2) 取第3字之後（名）

onOpen() 開檔時自動執行的觸發器

createMenu() 在選單列新增自訂按鈕