SuitsDocs
레퍼런스노드 레퍼런스액션액션연동연동

Google Sheets

Google Sheets에 데이터를 추가하거나 업데이트합니다.

개요

항목내용
카테고리연동
연동 필요Google OAuth 연결
출력작업 결과

설정 옵션

옵션설명필수
스프레드시트대상 스프레드시트
시트대상 시트 (탭)
작업행 추가, 행 업데이트, 데이터 읽기

작업 종류

행 추가 (Append Row)

새 행을 스프레드시트 맨 아래에 추가합니다.

열 매핑:
A: {{trigger.row.주문번호}}
B: {{trigger.row.고객명}}
C: {{trigger.row.금액}}
D: {{format(now, "YYYY-MM-DD HH:mm")}}

행 업데이트 (Update Row)

조건에 맞는 기존 행을 수정합니다.

조건: A열 = {{trigger.row.주문번호}}
업데이트:
D: {{trigger.row.상태}}
E: {{format(now, "YYYY-MM-DD")}}

데이터 읽기 (Read Data)

스프레드시트 데이터를 조회합니다.

범위: A1:E100
조건: B열 = {{trigger.row.고객명}}

출력 데이터

// 행 추가
{{actions.sheets.rowNumber}}     // 추가된 행 번호

// 데이터 읽기
{{actions.sheets.rows}}          // 조회된 데이터
{{actions.sheets.rows[0]}}       // 첫 번째 행
{{actions.sheets.count}}         // 조회된 행 수

활용 예시

주문 기록

트리거: 주문 데이터모델 - 행 생성
액션: Google Sheets - 행 추가
├── 스프레드시트: "2024년 주문 현황"
├── 시트: "주문목록"
└── 데이터:
    A: {{trigger.row.주문번호}}
    B: {{trigger.row.고객명}}
    C: {{trigger.row.금액}}
    D: {{format(trigger.row.주문일, "YYYY-MM-DD")}}

매출 리포트 업데이트

트리거: 일정 (매일 자정)
액션 1: 행 조회 (오늘 매출 합계)
액션 2: Google Sheets - 행 추가
├── 스프레드시트: "매출 리포트"
├── 시트: "일별"
└── 데이터:
    A: {{format(today, "YYYY-MM-DD")}}
    B: {{actions.query.totalAmount}}
    C: {{actions.query.orderCount}}

기존 데이터 업데이트

트리거: 배송 상태 변경
액션: Google Sheets - 행 업데이트
├── 조건: A열 (주문번호) = {{trigger.row.주문번호}}
└── 업데이트:
    E: {{trigger.row.배송상태}}
    F: {{format(now, "YYYY-MM-DD HH:mm")}}

모범 사례

헤더 행 유지

첫 번째 행은 헤더로 유지하고, 데이터는 2행부터 추가하세요.

날짜 형식 통일

날짜는 일관된 형식으로 저장하세요.

{{format(now, "YYYY-MM-DD HH:mm:ss")}}

대량 데이터 주의

한 번에 너무 많은 데이터를 처리하면 API 제한에 걸릴 수 있습니다.