구글시트에 입금 내역 쌓기 (Apps Script)
입금 내역을 회계 담당자와 함께 보거나, 간단한 집계를 하려면 구글시트가 편합니다. 서버를 따로 두지 않아도 구글시트에 딸린 Apps Script 로 82bank API 를 정해진 시간마다 불러 새 입금을 한 줄씩 붙일 수 있습니다. 이 글의 코드는 그대로 붙여 넣어 쓸 수 있게 짰습니다.
왜 웹훅이 아니라 주기 호출인가
Apps Script 도 웹 앱으로 배포하면 웹훅 주소를 만들 수 있습니다. 하지만 Apps Script 웹 앱은 요청 헤더를 읽을 수 없어서 X-82bank-Signature 서명을 검증할 방법이 없습니다. 주소만 알면 누구나 가짜 입금을 시트에 넣을 수 있다는 뜻입니다. 그래서 여기서는 Apps Script 가 직접 82bank 를 부르는 방식을 씁니다. 키를 아는 쪽이 부르는 것이니 받은 내용을 믿을 수 있습니다.
1. 시트와 스크립트 만들기
- 새 구글시트를 만들고 첫 시트 이름을
입금으로 바꿉니다. - 메뉴 [확장 프로그램] → [Apps Script] 를 엽니다.
- 왼쪽 [프로젝트 설정] → [스크립트 속성]에
BANK82_KEY,BANK82_SECRET,ACCOUNT_ID세 개를 넣습니다. 키를 코드에 직접 쓰면 시트를 공유받은 사람이 볼 수 있으니 속성에 둡니다.
2. 코드 붙여 넣기
const BASE = "https://82bank.app/v1";
function syncDeposits() {
const props = PropertiesService.getScriptProperties();
const auth = "Bearer " + props.getProperty("BANK82_KEY") + ":" + props.getProperty("BANK82_SECRET");
const accountId = props.getProperty("ACCOUNT_ID");
const sheet = SpreadsheetApp.getActive().getSheetByName("입금");
if (sheet.getLastRow() === 0) {
sheet.appendRow(["날짜", "시각", "보낸 분", "금액", "잔액", "적요", "거래 id"]);
}
// 이미 적은 거래 id (G열)
const seen = new Set(
sheet.getLastRow() > 1
? sheet.getRange(2, 7, sheet.getLastRow() - 1, 1).getValues().map((r) => r[0])
: []
);
const tz = "Asia/Seoul";
const to = Utilities.formatDate(new Date(), tz, "yyyy-MM-dd");
const from = Utilities.formatDate(new Date(Date.now() - 86400000), tz, "yyyy-MM-dd");
const rows = [];
let cursor = "";
do {
let url = BASE + "/accounts/" + accountId + "/transactions?type=deposit&limit=500&from=" + from + "&to=" + to;
if (cursor) url += "&cursor=" + encodeURIComponent(cursor);
const res = UrlFetchApp.fetch(url, { headers: { Authorization: auth }, muteHttpExceptions: true });
const data = JSON.parse(res.getContentText());
if (res.getResponseCode() !== 200) {
console.log("실패", res.getResponseCode(), data.code, data.message);
return; // 429 등은 다음 실행 때 다시
}
for (const t of data.items) {
if (!seen.has(t.id)) rows.push([t.date, t.time, t.counterparty, t.amount, t.balance, t.description, t.id]);
}
cursor = data.nextCursor;
} while (cursor);
rows.reverse(); // 저장 내역은 최신순 → 시트에는 오래된 것부터
if (rows.length) sheet.getRange(sheet.getLastRow() + 1, 1, rows.length, 7).setValues(rows);
console.log("새 입금 " + rows.length + "건");
}
한 번 실행할 때 어제와 오늘의 입금을 받아, 시트 G열에 이미 있는 거래 id 는 건너뛰고 새것만 아래에 붙입니다. 기간을 이틀로 겹쳐 잡는 것은 자정 무렵에 들어온 입금을 놓치지 않기 위해서입니다. 같은 거래는 몇 번 받아도 id 가 같아서 두 번 적히지 않습니다.
3. 처음 실행과 권한
편집기 위쪽에서 syncDeposits 를 고르고 [실행]을 누릅니다. 처음에는 구글이 "외부 서비스에 연결"과 "스프레드시트 수정" 권한을 묻습니다. 허용하면 실행 기록에 새 입금 n건 이 찍히고 시트에 줄이 생깁니다. 새 입금이 없으면 줄이 생기지 않으니, 등록한 계좌로 작은 금액을 입금하고 관리 화면에서 [지금 수집]을 한 뒤 실행해 보면 됩니다.
4. 10분마다 돌리기
왼쪽 [트리거](시계 모양) → [트리거 추가]에서 실행할 함수 syncDeposits, 이벤트 소스 [시간 기반], 유형 [분 단위 타이머], 간격 [10분마다]를 고르고 저장합니다. 이제 시트를 닫아 두어도 10분마다 새 입금이 쌓입니다. 한 번 실행에 보통 한 번만 호출하므로 키당 30분 60회 한도에 걸릴 일은 거의 없습니다. 계좌가 여러 개면 ACCOUNT_ID 대신 계좌 id 를 쉼표로 넣고 반복문으로 돌리면 됩니다.
쓸 때 알아 둘 것
- 출금도 쌓으려면 주소의
type=deposit을 빼고, 시트에 구분 열(t.type)을 하나 더 두세요. - 시트는 공유한 사람 모두가 봅니다. 잔액을 보여 주고 싶지 않으면 잔액 열을 빼세요.
- Apps Script 의 시간 기반 트리거는 정확히 정각에 돌지 않고 몇 분 늦을 수 있습니다. 입금 확인을 고객에게 바로 알려야 하는 일이라면 서버에서 웹훅을 받는 쪽이 맞습니다.
- 키를 폐기하면 스크립트 속성의 값도 새 키로 바꿔야 합니다.