Google Apps Script 連動程式碼
function getOrCreateMonthSheets(ss, ym, budgets) {
// ym 格式例如 "2026-12" -> 分頁名稱 "2026-12明細記帳" 與 "2026-12預算表"
var ledgerName = ym + '明細記帳';
var budgetName = ym + '預算表';
var lSheet = ss.getSheetByName(ledgerName);
if (!lSheet) {
lSheet = ss.insertSheet(ledgerName);
lSheet.appendRow(['日期', '類型', '店家/項目', '分類', '金源/付款方式', '金額(JPY)', '歸屬預算', '備註']);
lSheet.getRange(1, 1, 1, 8).setFontWeight('bold').setBackground('#0f172a').setFontColor('#ffffff');
lSheet.setFrozenRows(1);
}
var bSheet = ss.getSheetByName(budgetName);
if (!bSheet) {
bSheet = ss.insertSheet(budgetName);
bSheet.appendRow(['預算項目', '每月上限(JPY)', '已使用(自動統計)', '剩餘額度', '使用率']);
bSheet.getRange(1, 1, 1, 5).setFontWeight('bold').setBackground('#065f46').setFontColor('#ffffff');
var list = (budgets && budgets.length) ? budgets : [
{name: '日常伙食/日用', cap: 18500},
{name: '固定水電/通訊/交通', cap: 12000},
{name: '美容/儀容/個人護理', cap: 6600},
{name: '旅遊/住宿/特別開銷', cap: 30000}
];
list.forEach(function(b, idx) {
var row = idx + 2;
bSheet.appendRow([
b.name,
b.cap,
"=SUMIFS('" + ledgerName + "'!F:F, '" + ledgerName + "'!B:B, " + '"expense"' + ", '" + ledgerName + "'!G:G, A" + row + ")",
'=B' + row + '-C' + row,
'=IF(B' + row + '>0, C' + row + '/B' + row + ', 0)'
]);
});
bSheet.getRange(2, 5, list.length, 1).setNumberFormat('0.0%');
}
return { lSheet: lSheet, bSheet: bSheet };
}
function doPost(e) {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var payload = JSON.parse(e.postData.contents);
if (payload.action === 'appendExpense') {
var d = payload.data;
var ym = (d.date || '2026-11').slice(0, 7);
var sheets = getOrCreateMonthSheets(ss, ym, payload.budgets);
sheets.lSheet.appendRow([d.date, d.type || 'expense', d.merchant, d.category, d.payment, d.amount, d.bucketName || d.bucket || '', 'App自動同步']);
return ContentService.createTextOutput(JSON.stringify({ok: true, month: ym})).setMimeType(ContentService.MimeType.JSON);
}
if (payload.action === 'ping') {
return ContentService.createTextOutput(JSON.stringify({ok: true, msg: 'Sheet 連線正常'})).setMimeType(ContentService.MimeType.JSON);
}
if (payload.action === 'syncAll') {
// 1. 同步各金源資金水位
if (payload.accountsList && payload.accountsList.length) {
var accSheet = ss.getSheetByName('資金水位總覽') || ss.insertSheet('資金水位總覽');
accSheet.clear();
accSheet.appendRow(['帳戶名稱', '類型', '目前餘額(JPY)', '警戒水位(JPY)', '水位差額', '備註', '最後同步時間']);
accSheet.getRange(1, 1, 1, 7).setFontWeight('bold').setBackground('#0f172a').setFontColor('#ffffff');
var nowStr = Utilities.formatDate(new Date(), 'Asia/Tokyo', 'yyyy-MM-dd HH:mm:ss');
payload.accountsList.forEach(function(a) {
accSheet.appendRow([a.name, a.type, a.balance, a.target, a.balance - a.target, a.note || '', nowStr]);
});
}
// 2. 依月份同步明細與預算表
var grouped = {};
(payload.ledger || []).forEach(function(r) {
var ym = (r.date || '2026-11').slice(0, 7);
if (!grouped[ym]) grouped[ym] = [];
grouped[ym].push(r);
});
Object.keys(grouped).forEach(function(ym) {
var sheets = getOrCreateMonthSheets(ss, ym, payload.budgets);
var lSheet = sheets.lSheet;
if (lSheet.getLastRow() > 1) lSheet.getRange(2, 1, lSheet.getLastRow() - 1, 8).clearContent();
grouped[ym].forEach(function(r) {
lSheet.appendRow([r.date, r.type, r.merchant, r.category, r.payment, r.amount, r.bucketName || r.bucket || '', '全量同步']);
});
});
return ContentService.createTextOutput(JSON.stringify({ok: true, syncedMonths: Object.keys(grouped)})).setMimeType(ContentService.MimeType.JSON);
}
return ContentService.createTextOutput(JSON.stringify({ok: false})).setMimeType(ContentService.MimeType.JSON);
}
function doGet(e) {
return ContentService.createTextOutput(JSON.stringify({ok: true, msg: 'Apps Script 運作中'})).setMimeType(ContentService.MimeType.JSON);
}