googlesheet

bun만으로 Google Sheets를 OAuth 인증 후 읽고, 다른 시트에 새 헤더 구조로 append 하는 예제입니다.

준비

Google Cloud Console에서 Google Sheets API를 활성화합니다.
OAuth client ID를 생성합니다.
애플리케이션 유형은 Web application으로 만들고 아래 Redirect URI를 추가합니다.

http://127.0.0.1:3487/oauth2callback

.env.example를 참고해서 .env 파일을 만듭니다.

실행

bun run index.ts

특정 날짜만 추출하려면 --date 옵션을 사용합니다.

bun run google/index.ts --date 2026-04-27

환경변수로도 줄 수 있습니다.

GOOGLE_FILTER_DATE=2026-04-27 bun run google/index.ts

특정 범위만 가져오려면 날짜 뒤에 A1 range를 넘기면 됩니다.

bun run google/index.ts --date 2026-04-27 "A1:C20"

대상 시트 URL까지 직접 넘기려면 그 다음 인자를 사용하면 됩니다.

bun run google/index.ts --date 2026-04-27 "A1:Z999" "대상시트URL"

동작 방식

시트 URL에서 spreadsheetId와 gid를 자동 파싱합니다.
첫 실행 시 브라우저에서 Google OAuth 인증을 받습니다.
발급된 refresh token은 .tokens/google-oauth-token.json에 저장됩니다.
이후 실행부터는 저장된 refresh token으로 access token을 갱신합니다.
첫 번째 행을 원본 헤더로 해석한 뒤 객체 행으로 변환합니다.
created_time이 실행 시 받은 날짜(YYYY-MM-DD, KST 기준)와 일치하는 행만 추출합니다.
대상 시트에는 아래 헤더를 1행에 보장한 뒤 데이터를 append 합니다.

id
created_time
campaign_name
form_name
platform
full_name
phone_number
site
created_at
activation_channel
customer_group
sales_point
contact_number
primary_product
status
key

원본 헤더와 대상 헤더 이름이 같으면 해당 값을 복사합니다.
없는 컬럼은 빈 문자열로 들어갑니다.

2.0 KiB Raw Blame History

googlesheet

준비

실행

동작 방식

2.0 KiB

Raw Blame History