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