구글 시트 서식¶
구글 시트 서식 스킬은 Google Sheets 스프레드시트에 다양한 서식을 적용합니다. 볼드, 배경색, 테두리, 숫자 형식, 셀 병합, 열 너비 조정 등을 지원합니다.
설정 방법¶
1. 스킬 노드 추가¶
캔버스에서 이전 노드의 + 버튼을 클릭하고 스킬 노드를 추가합니다.
2. 구글 시트 서식 스킬 선택¶
우측 패널의 스킬 탭에서 구글 시트 서식을 선택합니다.
3. Google OAuth 인증 연결¶
인증 탭에서 등록된 Google OAuth 인증 정보를 선택합니다. 미등록 시 새 인증 추가를 클릭하여 Google 계정을 연동합니다.
4. 파라미터 입력¶
설정 탭에서 스프레드시트 ID와 서식 요청 배열을 입력합니다. {{를 입력하면 변수 셀렉터가 나타납니다.
파라미터¶
| 파라미터 | 필수 | 설명 |
|---|---|---|
| spreadsheet_id | O | 스프레드시트 ID (URL의 /d/ 뒤 문자열) |
| requests | O | 서식 요청 배열 (아래 서식 타입 참조) |
서식 타입 (requests 배열 내 type)¶
| type | 설명 | 추가 필드 |
|---|---|---|
| bold | 볼드 적용 | range |
| color | 배경색 적용 | range, red, green, blue (0~1) |
| text_color | 글자색 적용 | range, red, green, blue (0~1) |
| border | 테두리 적용 | range, style (SOLID, DASHED, DOTTED) |
| number_format | 숫자 형식 | range, pattern (예: #,##0, 0.00%) |
| merge | 셀 병합 | range |
| resize | 열/행 크기 조정 | dimension (COLUMNS, ROWS), start_index, end_index, size |
| alignment | 텍스트 정렬 | range, horizontal (LEFT, CENTER, RIGHT), vertical (TOP, MIDDLE, BOTTOM) |
range는 Sheet1!A1:D1 형식으로 지정합니다.
인증 정보¶
Google OAuth 인증이 필요합니다.
| 항목 | 설명 |
|---|---|
| access_token | Google OAuth 액세스 토큰 (자동 갱신) |
| refresh_token | 토큰 갱신을 위한 리프레시 토큰 |
Google 계정 연동 시 Google Sheets 읽기/쓰기 권한이 필요합니다.
출력¶
{
"success": true,
"data": {
"spreadsheet_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
"applied_requests": 3
}
}
출력 참조¶
{{ $('skill_1').data_content.result.spreadsheet_id }} → 스프레드시트 ID
{{ $('skill_1').data_content.result.applied_requests }} → 적용된 서식 수
사용 예시¶
보고서 헤더 서식 적용¶
시트 생성 후 헤더 행에 볼드, 배경색, 테두리를 일괄 적용합니다.
| 파라미터 | 값 |
|---|---|
| spreadsheet_id | {{ $('skill_create').data_content.result.spreadsheet_id }} |
| requests | [{"type": "bold", "range": "Sheet1!A1:E1"}, {"type": "color", "range": "Sheet1!A1:E1", "red": 0.2, "green": 0.4, "blue": 0.8}, {"type": "border", "range": "Sheet1!A1:E20", "style": "SOLID"}] |
금액 열에 숫자 형식 적용¶
| 파라미터 | 값 |
|---|---|
| spreadsheet_id | {{ $('trigger').data_content.spreadsheet_id }} |
| requests | [{"type": "number_format", "range": "Sheet1!D2:D100", "pattern": "#,##0"}] |
참고¶
requests배열에 여러 서식을 한 번에 전달하면 순서대로 적용됩니다.color의 RGB 값은 0~1 사이의 실수입니다 (예: 빨강 =red: 1, green: 0, blue: 0).- 시트 생성 → 데이터 쓰기 → 서식 적용 순서로 워크플로우를 구성하면 효율적입니다.