Googlesheets Upsert Rows

通过 Aident Loadout 使用 Google Sheets Tools 的 Googlesheets Upsert Rows。执行前查看输入、输出、设置、价格和风险。

写入操作风险等级 2/5OAuth 连接

服务提供商说明

Upsert rows - update existing rows by key, append new ones. Automatically handles column mapping and partial updates. Use for: CRM syncs (match Lead ID), transaction imports (match Transaction ID), inventory updates (match SKU), calendar syncs (match Event ID). Features: - Auto-…

Preparing Your Aident Workspace...

输入

rowsarray
必填
2D array of data rows to upsert. IMPORTANT: If 'headers' is NOT provided, the FIRST row is treated as column headers and remaining rows as data - so you need at least 2 rows (1 header + 1 data). If 'headers' IS provided separately, then ALL rows in this array are treated as data…
headersarray
List of column names for the data. These will be matched against sheet headers. If a column doesn't exist in the sheet, it will be added automatically. Order doesn't need to match sheet order. Can be auto-derived from the first row in 'rows' if not provided. Example inputs: ['Em…
keyColumnstring
The column NAME (header text) to use as unique identifier for matching rows. Must be an actual header name from the sheet (e.g., 'Email', 'Lead ID', 'SKU'), NOT a column letter (e.g., 'A', 'B', 'C'). If you provide a column letter like 'A', it will be automatically converted to…
sheetNamestring
必填
The name of the sheet/tab within the spreadsheet. Note: Google Sheets creates default sheets with localized names based on account language (e.g., 'Sheet1' for English, '工作表1' for Chinese, 'Hoja1' for Spanish, 'Feuille1' for French, 'Planilha1' for Portuguese, 'Лист1' for Russia…
strictModeboolean
Controls how rows with mismatched column counts are handled. When True (default), an error is returned if any row has more values than headers - the error message shows exactly which rows are affected and what values would need to be removed. When False, extra values are silentl…
tableStartstring
Cell where the table starts (where headers are located). Defaults to 'A1'. Use this if your table is offset (e.g., 'C5', 'D10').
spreadsheetIdstring
必填
The ID of the spreadsheet. Must be a non-empty string, typically a 44-character alphanumeric string found in the spreadsheet URL.
key_column_index
The 0-based column index to use as unique identifier for matching rows. Alternative to 'key_column' - will be converted to column name using headers. If neither 'key_column' nor 'key_column_index' is provided, defaults to 0 (first column). Example: 0 for first column, 1 for seco…
normalization_messagestring
Internal field to track input normalization (e.g., row truncation). Not part of API.

Googlesheets Upsert Rows

服务提供商说明

Googlesheets Upsert Rows

服务提供商说明

价格与限制

输入

可观察输出

使用此操作的技能

使用此操作的技能

相关使用场景

官方来源

使用此操作的技能