Google Sheets로 돌아가기

Knoon AI를 Google Sheets (Google)과 연결하여 AI 워크플로우를 자동화하세요.

Insert a new row or update an existing row in a Google Sheet based on a match in a specific column.

googleSheetsUpsertRow

베타

권한

https://www.googleapis.com/auth/drive.file

선택사항 권한

https://www.googleapis.com/auth/drive

매개변수

이름	유형	설명	필수
spreadsheetId	file	Select the Google Sheets file where the row should be inserted or updated.	네
sheetName	mustache	Name of the sheet (tab) to search and upsert the row in (e.g. "Sheet1").	네
matchColumn	mustache	Column used as the unique identifier for matching rows (e.g. "A" for the first column).	네
matchValue	mustache	Value to search for in the match column. If found, that row will be updated; if not, a new row will be inserted.	네
valueInputOption	string	How to treat the cell values: RAW = store exactly as given, USER_ENTERED = let Sheets parse values and formulas.	네
values	array (mustache)	Full row values to write.	네

반환값

이름	유형	설명
status	string	INSERTED, UPDATED, or ERROR.
sensitive.spreadsheetId	string	Spreadsheet ID.
sensitive.sheetName	string	Sheet name where the row was written.
sensitive.updatedRange	string	Range that was inserted or updated.
sensitive.matched	boolean	Whether a matching row was found before writing.