구글 시트 쓰기¶

구글 시트 쓰기 스킬은 Google Sheets 스프레드시트에 데이터를 쓰거나 기존 데이터 뒤에 추가합니다. 업데이트(update) 및 추가(append) 모드를 지원합니다.

설정 방법¶

1. 스킬 노드 추가¶

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

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

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

3. Google OAuth 인증 연결¶

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

4. 파라미터 입력¶

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

파라미터¶

파라미터	필수	설명
spreadsheet_id	O	스프레드시트 ID (URL의 `/d/` 뒤 문자열)
range	O	쓸 범위 (예: `Sheet1!A1:D10`, `Sheet1!A:A`)
values	O	쓸 데이터 (2D 배열)
mode		쓰기 모드 (`update`, `append`). 기본: `update`
value_input		값 입력 방식 (`RAW`, `USER_ENTERED`). 기본: `USER_ENTERED`

인증 정보¶

Google OAuth 인증이 필요합니다.

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

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

출력¶

{
  "success": true,
  "data": {
    "updated_range": "Sheet1!A1:C3",
    "updated_rows": 3,
    "updated_columns": 3,
    "updated_cells": 9
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.updated_range }}    → 업데이트된 범위
{{ $('skill_1').data_content.result.updated_rows }}     → 업데이트된 행 수
{{ $('skill_1').data_content.result.updated_cells }}    → 업데이트된 셀 수

사용 예시¶

주문 데이터를 시트에 자동 추가¶

웹훅으로 수신한 주문 데이터를 스프레드시트에 자동으로 추가하는 워크플로우입니다.

파라미터	값
spreadsheet_id	`1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms`
range	`주문!A:E`
values	`[["{{ $('trigger').data_content.order_id }}", "{{ $('trigger').data_content.product }}", "{{ $('trigger').data_content.quantity }}", "{{ $('trigger').data_content.price }}", "{{ $('trigger').data_content.date }}"]]`
mode	`append`

AI 분석 결과를 시트에 기록¶

AI 에이전트의 분석 결과를 지정된 셀에 업데이트합니다.

파라미터	값
spreadsheet_id	`{{ $('skill_read').data_content.result.spreadsheet_id }}`
range	`분석결과!A1`
values	`[["분석 결과"], ["{{ $('agent_1').text_content }}"]]`
mode	`update`

참고¶

mode를 append로 설정하면 지정 범위의 마지막 데이터 다음 행에 추가합니다.
value_input을 RAW로 설정하면 수식이 텍스트로 입력됩니다. USER_ENTERED는 수식을 해석합니다.
values는 반드시 2D 배열 형태여야 합니다 (예: [["A", "B"], ["C", "D"]]).