knoten / builtin / integration
Google Sheets
Integrate with Google Sheets to perform operations on spreadsheets and data.
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
Read rows from a Google Sheet, add or update rows, and create, clear or delete spreadsheets and their tabs.
Try it
Section titled “Try it”Save All Page Links to Sheet: ein Workflow mit 4 Schritten, beginnend mit When Started und endend mit Add a row per link.
What it does
Section titled “What it does”The Google Sheets node works on three kinds of things (Resource):
- Spreadsheet: list your spreadsheets, get one, create one (optionally with several tabs), delete one, or clear a range of cells.
- Worksheet (a tab inside a spreadsheet): list, get, create, delete, or clear a range.
- Data: get the values of a range, append a row, or update a row. Each comes in two versions: …from Spreadsheet / …into Spreadsheet, where Range names the tab (
Sheet1!A1:C10), and …from Worksheet / …into Worksheet, where you pick the tab in Worksheet and Range is just the cells (A1:C10).
For append and update, the node writes one row each time it runs and puts each value under the matching header in the first row of the tab, leaving the other cells empty. With the Worksheet versions, Data shows one field per column, named after those headers, so they are the easiest to fill.
Spreadsheet → List returns up to 10 spreadsheets from your Drive.
If Google returns an error, the node does not stop: it outputs success: false and the message in error. Add an IF on success when a failed write must not go unnoticed.
When to use it
Section titled “When to use it”- Log each scraped price, form entry or lead as a new row.
- Read a list of URLs or keywords from a sheet to drive a workflow.
- Update a status column once a row has been processed.
- Use Airtable or Baserow / NocoDB instead if your data lives there.
Inputs and settings
Section titled “Inputs and settings”| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Credential (erforderlich) | Credential | The Credential to use to make request. |
16 Auswahlmöglichkeiten · wählen Sie Resource and Spreadsheet Operation, um die Einstellungen zu sehen
Einstellungen für Spreadsheet · List
Keine weiteren Einstellungen.
Einstellungen für Spreadsheet · Get
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
Einstellungen für Spreadsheet · Create
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Title (erforderlich) | Text | Title for the new spreadsheet or sheet. |
| Sheets | List of entries | |
| Sheets (each entry) › Sheet Title (erforderlich) | Text | |
| Sheets (each entry) › Index | Number | |
| Sheets (each entry) › Rows | Number | |
| Sheets (each entry) › Columns | Number |
Einstellungen für Spreadsheet · Delete
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
Einstellungen für Spreadsheet · Clear
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Range (erforderlich) | Text | The cell range in A1 notation (e.g., Sheet1!A1:C10). |
Einstellungen für Worksheet · List
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
Einstellungen für Worksheet · Get
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Worksheet (erforderlich) | Choice (loaded from your account) | The worksheet to work with. |
Einstellungen für Worksheet · Create
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Title (erforderlich) | Text | Title for the new spreadsheet or sheet. |
| Index | Number | |
| Rows | Number | |
| Columns | Number |
Einstellungen für Worksheet · Delete
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Worksheet (erforderlich) | Choice (loaded from your account) | The worksheet to work with. |
Einstellungen für Worksheet · Clear
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Worksheet (erforderlich) | Choice (loaded from your account) | The worksheet to work with. |
| Range (erforderlich) | Text | The cell range in A1 notation (e.g., Sheet1!A1:C10). |
Einstellungen für Data · Get Values from Spreadsheet
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Range (erforderlich) | Text | The cell range in A1 notation (e.g., Sheet1!A1:C10). |
Einstellungen für Data · Get Values from Worksheet
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Worksheet (erforderlich) | Choice (loaded from your account) | The worksheet to work with. |
| Range (erforderlich) | Text | The cell range in A1 notation (e.g., Sheet1!A1:C10). |
Einstellungen für Data · Append Values into Spreadsheet
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Range (erforderlich) | Text | The cell range in A1 notation (e.g., Sheet1!A1:C10). |
| Data (erforderlich) | Field list | Key-value object mapping column headers to values. |
| Value Input Option (erforderlich) | Choice | How to interpret input values. Options: User Entered, Raw. |
| Include Values In Response | Toggle |
Einstellungen für Data · Append Values into Worksheet
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Worksheet (erforderlich) | Choice (loaded from your account) | The worksheet to work with. |
| Range (erforderlich) | Text | The cell range in A1 notation (e.g., Sheet1!A1:C10). |
| Data (erforderlich) | Field list | Key-value object mapping column headers to values. |
| Value Input Option (erforderlich) | Choice | How to interpret input values. Options: User Entered, Raw. |
| Include Values In Response | Toggle |
Einstellungen für Data · Update Values in Spreadsheet
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Range (erforderlich) | Text | The cell range in A1 notation (e.g., Sheet1!A1:C10). |
| Data (erforderlich) | Field list | Key-value object mapping column headers to values. |
| Value Input Option (erforderlich) | Choice | How to interpret input values. Options: User Entered, Raw. |
| IncludeValuesInResponse | Toggle |
Einstellungen für Data · Update Values in Worksheet
| Einstellung | Typ | Was es bewirkt |
|---|---|---|
| Spreadsheet (erforderlich) | Choice (loaded from your account) | The spreadsheet to work with. |
| Worksheet (erforderlich) | Choice (loaded from your account) | The worksheet to work with. |
| Range (erforderlich) | Text | The cell range in A1 notation (e.g., Sheet1!A1:C10). |
| Data (erforderlich) | Field list | Key-value object mapping column headers to values. |
| Value Input Option (erforderlich) | Choice | How to interpret input values. Options: User Entered, Raw. |
| IncludeValuesInResponse | Toggle |
Einstellungen für Spreadsheet · List werden angezeigt
- Range uses A1 notation:
A1:D(columns A to D, all rows),2:2(row 2), orSheet1!A1:C10with the tab name. For append, a range covering your table, such asA:D, is enough: Google adds the row after the last filled one. - Put column names in row 1 before you append: they are the field names shown in Data.
- Value Input Option: User Entered reads values as if you typed them (so
=SUM(A2:A9)becomes a formula and2026-09-10a date). Raw stores them exactly as text. - Turn on Include Values In Response to get the written row back in the output.
Outputs
Section titled “Outputs”-
Output
- Get Values returns
rangeandvalues, a list of rows, each row a list of cell values. The first row is usually your headers. - Append and update return what Google reports: the updated range and the number of cells changed (plus the values when Include Values In Response is on).
- Spreadsheet → Get and Create return the spreadsheet with its
spreadsheetId,propertiesandsheets. - Delete and Clear return
success: true; any failure returnssuccess: falseanderror.
Dependencies and credentials
Section titled “Dependencies and credentials”- Credential (connection, OAuth2): required. See Create a connection.
Google Sheets connects by signing in to your Google account (OAuth). You first create your own Google OAuth client once, with both the Google Sheets API and the Google Drive API enabled (the spreadsheet list is read through Drive): follow Create your OAuth client. Then create a Google Sheets credential, paste the Client ID and Client Secret, click Check connection and approve the Google window. AWFlow asks to read and edit your spreadsheets and to see the names of your Drive files. The sign-in is kept and refreshed for you. See also Create a credential.
Example workflow
Section titled “Example workflow”- A Context Menu trigger runs when you right-click a product page.
- Information Extractor reads
nameandpricefrom the page text. - Google Sheets, Data → Append Values into Worksheet, spreadsheet
Price watch, worksheetProducts, RangeA:D, DataName={{ $input.name }},Price={{ $input.price }},URL={{ $('Context Menu').pageUrl }}, Value Input Option User Entered. - IF checks
{{ $input.success }}is notfalse, and a Browser Notification confirms the row.
Common issues
Section titled “Common issues”- The output has
success: falseand “Unable to parse range: …”. Range is not valid A1 notation, or names a tab that does not exist. Check the tab name, and quote it if it has spaces:'My data'!A1:C. - Values land in the wrong columns. Row 1 has no headers, or different ones from the Data fields, so values are written in field order. Add or fix the headers, then pick the worksheet again so Data shows the new columns.
- The spreadsheet list is empty or misses files. The Google Drive API is not enabled for your OAuth client, or the file is not among the 10 returned. Enable the API, or pick the spreadsheet by mapping its id.
- “… insufficient authentication scopes” or a 403 error. An API is not enabled, or the sign-in is older than the current permissions. Enable the Sheets and Drive APIs, then click Check connection again on the credential. To delete spreadsheet files, use Google Drive, whose sign-in can manage files.
Related nodes
Section titled “Related nodes”- Google Drive: manage the spreadsheet files themselves.
- Split Out: turn
valuesrows into one item each. - CSV: work with a CSV export instead.
- Airtable: a database-style alternative.