Zur App

DokumentationWorkflowsApps und Services

Google Sheets Node

Tabellen aus Google Sheets lesen, neue Zeilen anhängen oder einzelne Zellbereiche aktualisieren. Perfekt für Reports, Logs oder als Datenquelle für nachgelagerte AI-Schritte. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.

9 Min LesezeitAktualisiert am

Was Google Sheets macht

Tabellen aus Google Sheets lesen, neue Zeilen anhängen oder einzelne Zellbereiche aktualisieren. Perfekt für Reports, Logs oder als Datenquelle für nachgelagerte AI-Schritte.

  • Verarbeitet einen Eingang.
  • Stellt einen Ausgang für weitere Schritte bereit.
  • Wird als normaler Schritt in den Ablauf eingebunden.

Node einrichten

  1. 01Öffne einen Workflow und füge „Google Sheets“ über Bausteine hinzu.
  2. 02Wähle im Node-Panel deine Verbindung für google_byo. Falls noch keine besteht, öffnet sich die Einrichtung direkt im Workflow.
  3. 03Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
  4. 04Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
  5. 05Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.

Aktionen und Betriebsarten

Wähle im Feld „Aktion“ die gewünschte Funktion. Danach zeigt das Node-Panel nur die dafür relevanten Einstellungen.

  • Zeile anhängen
  • Bereich lesen
  • Bereich aktualisieren
  • Zeilen nach Spalten zuordnen

Einstellungen

FeldBedeutungBereich
AktionAuswahl: Zeile anhängen, Bereich lesen, Bereich aktualisieren, Zeilen nach Spalten zuordnenStandard
Tabelle (ID aus der URL)Öffne deine Tabelle in Google Sheets und kopiere den Code aus der Adresse: docs.google.com/spreadsheets/d/HIER/editStandard
BereichWelcher Zellbereich? Format wie in Sheets: Tabelle1!A:Z (ganze Spalten) oder Tabelle1!A2:D10. Leer lassen für die erste Spalte.Standard
WerteEine Zelle pro Zeile oder Wert. Du musst kein JSON tippen.Standard
ImportformatWird im Node-Panel konfiguriert.Erweitert
Google-KontoWähle das verbundene Google-OAuth-Profil für diese Tabelle.Standard
TabellenblattÜbernimm das Blatt aus der Vorlage oder gib seine ID ein. Unter den Optionen kannst du zur Auswahl nach Namen wechseln.Standard
Spalten zuordnenOrdne jedem Feld eine Spalte zu oder übernimm die Feldnamen automatisch. Alle eingehenden Datensätze werden gemeinsam geschrieben.Standard
Tabelle auswählen überAuswahl: ID, Gespeicherte Auswahl, LinkErweitert
Tabellenblatt auswählen überAuswahl: ID, Gespeicherte Auswahl, Name, LinkErweitert
Zeile mit ÜberschriftenWird im Node-Panel konfiguriert.Erweitert
Werte übernehmenSheets kann eingegebene Zahlen, Datumswerte und Formeln auswerten. Exakte Übernahme behält den gelieferten Wert.Erweitert
Neue Überschriften übernehmenAuswahl: Exakt übernehmen, Wie Eingabe in SheetsErweitert
Direkt anhängenSpart Anfragen bei Tabellen ohne Lücken zwischen Zeilen oder Spalten. Sonst ausgeschaltet lassen, damit neue Daten unter der letzten belegten Zeile stehen.Erweitert
Zusätzliche FelderGilt bei automatischer Zuordnung, wenn Eingabefelder noch keine passende Spalte haben.Erweitert
Für jedes Item einzeln ausführenAus (Standard): der Node läuft einmal für den gesamten Input. An: bekommt er mehrere Items (z. B. aus „Liste aufteilen“), läuft er einmal PRO Item, und {{ $json }} ist dabei jeweils genau dieses Item. So arbeitest du eine Dateiliste Eintrag für Eintrag ab.Erweitert
Wenn ein Item fehlschlägt„Überspringen“ schreibt für das fehlgeschlagene Item ein `error`-Feld und verarbeitet die übrigen weiter, statt den ganzen Lauf an einer einzigen unlesbaren Datei scheitern zu lassen.Erweitert
Pause zwischen Items (Millisekunden)Wartezeit vor jedem Durchlauf außer dem ersten. 1000 = 1 Sekunde pro Item. Nützlich, wenn die Gegenstelle sonst dichtmacht. Maximal 300000 (5 Minuten).Erweitert

Eingaben und Ausgaben

EingabeBedeutungTyp
StandardDer Node übernimmt das vollständige Ergebnis des vorherigen Schritts.JSON
AusgabeBedeutungTyp
StandardDas Ergebnis steht dem nächsten Schritt als JSON zur Verfügung.JSON

Dieser Node kann Listen Item für Item verarbeiten. Fehlerbehandlung und Pause zwischen Items findest du in den erweiterten Einstellungen.

Beispiel und Testlauf

Lead in Sheet schreiben: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.

Beispiel für einen Testlauf

{
  "range": "Leads!A:D",
  "values": [
    "Alice",
    "alice@example.com",
    "2026-04-19",
    "neu"
  ]
}

Zugriff und Sicherheit

Der Node verwendet eine verbundene google_byo-Verbindung. Prüfe die angezeigten Berechtigungen beim Verbinden und gib nur die benötigten Bereiche frei.

Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.

Häufige Fehler beheben

  • Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
  • Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.
  • Verbindung abgelehnt: Verbinde den Dienst erneut und erteile nur die Berechtigungen, die dieser Schritt benötigt.
  • Liste wird nur einmal verarbeitet: Aktiviere die Ausführung pro Item in den erweiterten Einstellungen.

Verwandte Artikel