구글 시트 읽기¶

구글 시트 읽기 스킬은 Google Sheets 스프레드시트에서 지정된 범위의 데이터를 읽어옵니다. 셀 값을 2D 배열 또는 객체 형태로 반환합니다.

설정 방법¶

1. 스킬 노드 추가¶

캔버스에서 이전 노드의 + 버튼을 클릭하고 스킬 노드를 추가합니다.

2. 구글 시트 읽기 스킬 선택¶

우측 패널의 스킬 탭에서 구글 시트 읽기를 선택합니다.

3. Google OAuth 인증 연결¶

인증 탭에서 등록된 Google OAuth 인증 정보를 선택합니다. 미등록 시 새 인증 추가를 클릭하여 Google 계정을 연동합니다.

4. 파라미터 입력¶

설정 탭에서 스프레드시트 ID, 범위 등을 입력합니다. {{를 입력하면 변수 셀렉터가 나타납니다.

파라미터¶

파라미터	필수	설명
spreadsheet_id	O	스프레드시트 ID (URL의 `/d/` 뒤 문자열)
range	O	읽을 범위 (예: `Sheet1!A1:D10`, `Sheet1`)
value_render		값 렌더링 방식 (`FORMATTED_VALUE`, `UNFORMATTED_VALUE`, `FORMULA`). 기본: `FORMATTED_VALUE`
output_format		출력 형식 (`array`, `objects`). 기본: `array`

인증 정보¶

Google OAuth 인증이 필요합니다.

항목	설명
access_token	Google OAuth 액세스 토큰 (자동 갱신)
refresh_token	토큰 갱신을 위한 리프레시 토큰

Google 계정 연동 시 Google Sheets 읽기/쓰기 권한이 필요합니다.

출력¶

{
  "success": true,
  "data": {
    "values": [
      ["이름", "이메일", "부서"],
      ["홍길동", "hong@example.com", "개발팀"],
      ["김철수", "kim@example.com", "디자인팀"]
    ],
    "range": "Sheet1!A1:C3",
    "row_count": 3,
    "column_count": 3
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.values }}        → 2D 배열
{{ $('skill_1').data_content.result.row_count }}      → 행 수
{{ $('skill_1').data_content.result.column_count }}   → 열 수
{{ $('skill_1').data_content.result.range }}           → 읽은 범위

사용 예시¶

스프레드시트 데이터를 이메일로 전송¶

트리거로 받은 스프레드시트에서 데이터를 읽어 이메일로 전송하는 워크플로우입니다.

파라미터	값
spreadsheet_id	`{{ $('trigger').data_content.spreadsheet_id }}`
range	`Sheet1!A1:D100`

데이터 읽기 후 AI 분석¶

시트 데이터를 읽어 AI 에이전트에게 분석을 요청할 수 있습니다.

파라미터	값
spreadsheet_id	`1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms`
range	`매출!A1:F50`
output_format	`objects`

참고¶

output_format을 objects로 설정하면 첫 행을 헤더로 사용하여 객체 배열로 반환합니다.
value_render를 FORMULA로 설정하면 수식 자체를 반환합니다.
범위를 시트 이름만 지정하면 (예: Sheet1) 해당 시트의 모든 데이터를 읽습니다.