구글 시트

ssemworks-microservice-base.googleSheets

통신/외부외부 서비스

Google Sheets 스프레드시트에 행을 추가(append)/조회(read)/키 매칭 갱신(update)하거나 범위를 클리어(clear)한다. 서비스 계정(JWT RS256) 인증 — OAuth 인프라 불요.

기본 정보

항목	값
서비스 타입	ssemworks-microservice-base.googleSheets
표시 이름	구글 시트
카테고리	통신/외부
그룹	input, output
버전	1,2,3,4,4.1,4.2,4.3,4.4,4.5,4.6,4.7

자격증명

이름	필수
googleApi	예

입출력

• 입력: 메인(main)
• 출력: 메인(main)

파라미터

파라미터	이름	타입	기본값	설명
작업	operation	선택	read	수행할 작업 선택지: 행 조회(read) · 행 추가(append) · 행 갱신 (키 매칭)(update) · 클리어(clear)
스프레드시트 (documentId)	documentId	문자열	""	스프레드시트 ID 또는 전체 URL(https://docs.google.com/spreadsheets/d/…). n8n resourceLocator 형태도 수용. 표현식 사용 가능 필수
시트 (sheetName)	sheetName	문자열	""	시트 이름·gid(숫자)·gid 포함 URL 모두 수용. 비우면 첫 번째 시트. 표현식 사용 가능
데이터 입력 방식	dataMode	선택	autoMapInputData	기록할 컬럼 값을 어디서 가져올지 선택지: 입력 데이터 자동 매핑(autoMapInputData) · 아래에서 지정(defineBelow) 표시 조건: operation = "append" 또는 "update"
설정할 값	fieldsToSet	고정 컬렉션	{}	추가/갱신 시 컬럼에 기록할 값 표시 조건: operation = "append" 또는 "update", dataMode = "defineBelow"
매칭 컬럼 (matchingColumns)	matchingColumns	문자열	id	이 컬럼(들)의 값이 일치하는 행을 찾아 갱신한다. 입력 아이템에 반드시 이 키의 값이 있어야 하며, 매칭 행이 없으면 명시 오류(아무 것도 갱신하지 않음) 표시 조건: operation = "update" 필수
범위 (range)	range	문자열	""	A1 표기 범위. 비우면 시트 전체. 시트명 포함(Sheet1!A1:D50) 형태도 수용 표시 조건: operation = "read" 또는 "clear"
옵션	options	컬렉션	{}	표시 조건: operation = "read" 또는 "append" 또는 "update"

ℹ️ 서비스 계정 인증: 대상 스프레드시트를 서비스 계정 이메일(자격증명의 email)과 공유(편집자)해야 접근할 수 있습니다.

설정할 값 › 값 하위 필드

파라미터	이름	타입	기본값	설명
컬럼 이름	columnName	문자열	""	헤더 행의 컬럼명
값	value	문자열	""	기록할 값. 표현식 사용 가능 (={{ $json.필드 }})

옵션 하위 필드

파라미터	이름	타입	기본값	설명
셀 입력 형식 (cellFormat)	cellFormat	선택	USER_ENTERED	append/update 시 값 해석 방식 선택지: USER_ENTERED (수식/숫자 해석)(USER_ENTERED) · RAW (그대로 저장)(RAW)
값 렌더 옵션 (valueRenderOption)	valueRenderOption	선택	UNFORMATTED_VALUE	read 시 셀 값 반환 방식 선택지: UNFORMATTED_VALUE (원시 값 — 숫자는 숫자로)(UNFORMATTED_VALUE) · FORMATTED_VALUE (표시 형식 적용 문자열)(FORMATTED_VALUE) · FORMULA (수식 원문)(FORMULA)