返回 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.