Voltar para Google Sheets
Conectar Knoon AI com Google Sheets (Google) para automatizar fluxos de trabalho de AI.
Insert a new row or update an existing row in a Google Sheet based on a match in a specific column.
googleSheetsUpsertRow
Beta
Permissões
Permissões opcionais
Parâmetros
| Nome | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| spreadsheetId | file | Select the Google Sheets file where the row should be inserted or updated. | Sim |
| sheetName | mustache | Name of the sheet (tab) to search and upsert the row in (e.g. "Sheet1"). | Sim |
| matchColumn | mustache | Column used as the unique identifier for matching rows (e.g. "A" for the first column). | Sim |
| 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. | Sim |
| valueInputOption | string | How to treat the cell values: RAW = store exactly as given, USER_ENTERED = let Sheets parse values and formulas. | Sim |
| values | array (mustache) | Full row values to write. | Sim |
Devoluções
| Nome | Tipo | Descrição |
|---|---|---|
| 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. |




