78 lines
2.0 KiB
Markdown
78 lines
2.0 KiB
Markdown
# googlesheet
|
|
|
|
`bun`만으로 Google Sheets를 OAuth 인증 후 읽고, 다른 시트에 새 헤더 구조로 append 하는 예제입니다.
|
|
|
|
## 준비
|
|
|
|
1. Google Cloud Console에서 `Google Sheets API`를 활성화합니다.
|
|
2. `OAuth client ID`를 생성합니다.
|
|
3. 애플리케이션 유형은 `Web application`으로 만들고 아래 Redirect URI를 추가합니다.
|
|
|
|
```text
|
|
http://127.0.0.1:3487/oauth2callback
|
|
```
|
|
|
|
4. `.env.example`를 참고해서 `.env` 파일을 만듭니다.
|
|
|
|
## 실행
|
|
|
|
```bash
|
|
bun run index.ts
|
|
```
|
|
|
|
특정 날짜만 추출하려면 `--date` 옵션을 사용합니다.
|
|
|
|
```bash
|
|
bun run google/index.ts --date 2026-04-27
|
|
```
|
|
|
|
환경변수로도 줄 수 있습니다.
|
|
|
|
```bash
|
|
GOOGLE_FILTER_DATE=2026-04-27 bun run google/index.ts
|
|
```
|
|
|
|
특정 범위만 가져오려면 날짜 뒤에 A1 range를 넘기면 됩니다.
|
|
|
|
```bash
|
|
bun run google/index.ts --date 2026-04-27 "A1:C20"
|
|
```
|
|
|
|
대상 시트 URL까지 직접 넘기려면 그 다음 인자를 사용하면 됩니다.
|
|
|
|
```bash
|
|
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 합니다.
|
|
|
|
```text
|
|
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
|
|
```
|
|
|
|
- 원본 헤더와 대상 헤더 이름이 같으면 해당 값을 복사합니다.
|
|
- 없는 컬럼은 빈 문자열로 들어갑니다.
|