콘텐츠로 이동

구글 시트 서식

구글 시트 서식 스킬은 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)

rangeSheet1!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).
  • 시트 생성 → 데이터 쓰기 → 서식 적용 순서로 워크플로우를 구성하면 효율적입니다.