---
title: Google Sheets
description: Daten lesen, schreiben und aktualisieren
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="google_sheets"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Google Sheets](https://sheets.google.com) ist eine leistungsstarke cloudbasierte Tabellenkalkulationsanwendung, mit der Benutzer Tabellenkalkulationen in Echtzeit erstellen, bearbeiten und gemeinsam daran arbeiten können. Als Teil der Google-Produktivitätssuite bietet Google Sheets eine vielseitige Plattform für Datenorganisation, -analyse und -visualisierung mit robusten Formatierungs-, Formel- und Freigabefunktionen.

Erfahren Sie, wie Sie das Google Sheets "Lesen"-Tool in Sim integrieren, um mühelos Daten aus Ihren Tabellenkalkulationen abzurufen und in Ihre Workflows zu integrieren. Dieses Tutorial führt Sie durch die Verbindung mit Google Sheets, die Einrichtung von Datenabfragen und die Verwendung dieser Informationen zur Automatisierung von Prozessen in Echtzeit. Perfekt für die Synchronisierung von Live-Daten mit Ihren Agenten.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/xxP7MZRuq_0"
  title="Verwenden des Google Sheets Lese-Tools in Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Entdecken Sie, wie Sie das Google Sheets "Schreiben"-Tool in Sim verwenden können, um automatisch Daten aus Ihren Workflows an Ihre Google Sheets zu senden. Dieses Tutorial behandelt die Einrichtung der Integration, die Konfiguration von Schreibvorgängen und die nahtlose Aktualisierung Ihrer Tabellen während der Ausführung von Workflows. Perfekt für die Führung von Echtzeit-Aufzeichnungen ohne manuelle Eingabe.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/cO86qTj7qeY"
  title="Verwenden des Google Sheets Schreib-Tools in Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Erfahren Sie, wie Sie das Google Sheets "Aktualisieren"-Tool in Sim nutzen können, um bestehende Einträge in Ihren Tabellenkalkulationen basierend auf der Workflow-Ausführung zu ändern. Dieses Tutorial zeigt die Einrichtung der Aktualisierungslogik, das Mapping von Datenfeldern und die sofortige Synchronisierung von Änderungen. Perfekt, um Ihre Daten aktuell und konsistent zu halten.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/95by2fL9yn4"
  title="Verwenden Sie das Google Sheets Update-Tool in Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Erfahren Sie, wie Sie das Google Sheets "Append"-Tool in Sim verwenden können, um mühelos neue Datenzeilen während der Workflow-Ausführung zu Ihren Tabellen hinzuzufügen. Dieses Tutorial führt Sie durch die Einrichtung der Integration, die Konfiguration von Append-Aktionen und die Sicherstellung eines reibungslosen Datenwachstums. Perfekt für die Erweiterung von Datensätzen ohne manuellen Aufwand!

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/8DgNvLBCsAo"
  title="Verwenden Sie das Google Sheets Append-Tool in Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Mit Google Sheets können Sie:

- **Tabellen erstellen und bearbeiten**: Entwickeln Sie datengesteuerte Dokumente mit umfassenden Formatierungs- und Berechnungsoptionen
- **In Echtzeit zusammenarbeiten**: Arbeiten Sie gleichzeitig mit mehreren Benutzern an derselben Tabelle
- **Daten analysieren**: Verwenden Sie Formeln, Funktionen und Pivot-Tabellen, um Ihre Daten zu verarbeiten und zu verstehen
- **Informationen visualisieren**: Erstellen Sie Diagramme, Grafiken und bedingte Formatierungen, um Daten visuell darzustellen
- **Überall zugreifen**: Nutzen Sie Google Sheets geräteübergreifend mit automatischer Cloud-Synchronisierung
- **Offline arbeiten**: Arbeiten Sie ohne Internetverbindung weiter, wobei Änderungen synchronisiert werden, sobald Sie wieder online sind
- **Mit anderen Diensten integrieren**: Verbinden Sie mit Google Drive, Forms und Drittanbieteranwendungen

In Sim ermöglicht die Google Sheets-Integration Ihren Agenten, direkt programmatisch mit Tabellendaten zu interagieren. Dies ermöglicht leistungsstarke Automatisierungsszenarien wie Datenextraktion, -analyse, -berichterstattung und -verwaltung. Ihre Agenten können bestehende Tabellen lesen, um Informationen zu extrahieren, in Tabellen schreiben, um Daten zu aktualisieren, und neue Tabellen von Grund auf erstellen. Diese Integration überbrückt die Lücke zwischen Ihren KI-Workflows und der Datenverwaltung und ermöglicht eine nahtlose Interaktion mit strukturierten Daten. Durch die Verbindung von Sim mit Google Sheets können Sie Daten-Workflows automatisieren, Berichte generieren, Erkenntnisse aus Daten gewinnen und aktuelle Informationen pflegen - alles durch Ihre intelligenten Agenten. Die Integration unterstützt verschiedene Datenformate und Bereichsspezifikationen, was sie flexibel genug macht, um unterschiedliche Datenverwaltungsanforderungen zu erfüllen, während die kollaborative und zugängliche Natur von Google Sheets erhalten bleibt.
{/* MANUAL-CONTENT-END */}

## Nutzungsanweisungen

Integriert Google Sheets in den Workflow. Kann Daten lesen, schreiben, anhängen und aktualisieren. Erfordert OAuth.

## Tools

### `google_sheets_read`

Daten aus einer Google Sheets-Tabelle lesen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Ja | Die ID der Tabelle \(zu finden in der URL: docs.google.com/spreadsheets/d/\{SPREADSHEET_ID\}/edit\). |
| `range` | string | Nein | Der A1-Notationsbereich zum Lesen \(z.B. "Sheet1!A1:D10", "A1:B5"\). Standardmäßig wird das erste Tabellenblatt A1:Z1000 verwendet, wenn nicht angegeben. |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `data` | json | Tabellendaten einschließlich Bereich und Zellwerte |
| `metadata` | json | Tabellenmetadaten einschließlich ID und URL |

### `google_sheets_write`

Daten in eine Google Sheets-Tabelle schreiben

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Ja | Die ID der Tabelle |
| `range` | string | Nein | Der A1-Notationsbereich, in den geschrieben werden soll \(z.B. "Sheet1!A1:D10", "A1:B5"\) |
| `values` | array | Ja | Die zu schreibenden Daten als 2D-Array \(z.B. \[\["Name", "Alter"\], \["Alice", 30\], \["Bob", 25\]\]\) oder Array von Objekten. |
| `valueInputOption` | string | Nein | Das Format der zu schreibenden Daten |
| `includeValuesInResponse` | boolean | Nein | Ob die geschriebenen Werte in der Antwort enthalten sein sollen |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `updatedRange` | string | Bereich der aktualisierten Zellen |
| `updatedRows` | number | Anzahl der aktualisierten Zeilen |
| `updatedColumns` | number | Anzahl der aktualisierten Spalten |
| `updatedCells` | number | Anzahl der aktualisierten Zellen |
| `metadata` | json | Tabellenmetadaten einschließlich ID und URL |

### `google_sheets_update`

Daten in einer Google Sheets-Tabelle aktualisieren

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Ja | Die ID der zu aktualisierenden Tabelle |
| `range` | string | Nein | Der A1-Notationsbereich, der aktualisiert werden soll \(z.B. "Sheet1!A1:D10", "A1:B5"\) |
| `values` | array | Ja | Die zu aktualisierenden Daten als 2D-Array \(z.B. \[\["Name", "Alter"\], \["Alice", 30\]\]\) oder Array von Objekten. |
| `valueInputOption` | string | Nein | Das Format der zu aktualisierenden Daten |
| `includeValuesInResponse` | boolean | Nein | Ob die aktualisierten Werte in der Antwort enthalten sein sollen |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `updatedRange` | string | Bereich der aktualisierten Zellen |
| `updatedRows` | number | Anzahl der aktualisierten Zeilen |
| `updatedColumns` | number | Anzahl der aktualisierten Spalten |
| `updatedCells` | number | Anzahl der aktualisierten Zellen |
| `metadata` | json | Tabellen-Metadaten einschließlich ID und URL |

### `google_sheets_append`

Daten am Ende einer Google Sheets-Tabelle anhängen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Ja | Die ID der Tabelle, an die angehängt werden soll |
| `range` | string | Nein | Der A1-Notationsbereich, an den angehängt werden soll (z.B. "Sheet1", "Sheet1!A:D") |
| `values` | array | Ja | Die anzuhängenden Daten als 2D-Array (z.B. [["Alice", 30], ["Bob", 25]]) oder Array von Objekten |
| `valueInputOption` | string | Nein | Das Format der anzuhängenden Daten |
| `insertDataOption` | string | Nein | Wie die Daten eingefügt werden sollen (OVERWRITE oder INSERT_ROWS) |
| `includeValuesInResponse` | boolean | Nein | Ob die angehängten Werte in der Antwort enthalten sein sollen |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `tableRange` | string | Bereich der Tabelle, in dem Daten angehängt wurden |
| `updatedRange` | string | Bereich der Zellen, die aktualisiert wurden |
| `updatedRows` | number | Anzahl der aktualisierten Zeilen |
| `updatedColumns` | number | Anzahl der aktualisierten Spalten |
| `updatedCells` | number | Anzahl der aktualisierten Zellen |
| `metadata` | json | Tabellenkalkulationsmetadaten einschließlich ID und URL |

## Hinweise

- Kategorie: `tools`
- Typ: `google_sheets`

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Ja | Google Sheets-Tabellenkalkulations-ID |
| `includeGridData` | boolean | Nein | Ob Rasterdaten \(Zellwerte\) einbezogen werden sollen. Standardmäßig false. |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | Die Tabellenkalkulations-ID |
| `title` | string | Der Titel der Tabellenkalkulation |
| `locale` | string | Das Gebietsschema der Tabellenkalkulation |
| `timeZone` | string | Die Zeitzone der Tabellenkalkulation |
| `spreadsheetUrl` | string | URL zur Tabellenkalkulation |
| `sheets` | array | Liste der Tabellenblätter in der Tabellenkalkulation |
|   ↳ `sheetId` | number | Die Tabellenblatt-ID |
|   ↳ `title` | string | Der Titel/Name des Tabellenblatts |
|   ↳ `index` | number | Der Tabellenblatt-Index \(Position\) |
|   ↳ `rowCount` | number | Anzahl der Zeilen im Tabellenblatt |
|   ↳ `columnCount` | number | Anzahl der Spalten im Tabellenblatt |
|   ↳ `hidden` | boolean | Ob das Tabellenblatt ausgeblendet ist |

### `google_sheets_create_spreadsheet`

Erstellt eine neue Google Sheets-Tabellenkalkulation

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `title` | string | Ja | Der Titel der neuen Tabellenkalkulation |
| `sheetTitles` | json | Nein | Array von Tabellenblattnamen, die erstellt werden sollen \(z. B. \["Tabelle1", "Daten", "Zusammenfassung"\]\). Standardmäßig ein einzelnes "Tabelle1". |
| `locale` | string | Nein | Das Gebietsschema der Tabellenkalkulation \(z. B. "de_DE"\) |
| `timeZone` | string | Nein | Die Zeitzone der Tabellenkalkulation \(z. B. "Europe/Berlin"\) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | Die ID der erstellten Tabellenkalkulation |
| `title` | string | Der Titel der erstellten Tabellenkalkulation |
| `spreadsheetUrl` | string | URL zur erstellten Tabellenkalkulation |
| `sheets` | array | Liste der in der Tabellenkalkulation erstellten Tabellenblätter |
|   ↳ `sheetId` | number | Die Tabellenblatt-ID |
|   ↳ `title` | string | Der Tabellenblatt-Titel/-Name |
|   ↳ `index` | number | Der Tabellenblatt-Index \(Position\) |

### `google_sheets_batch_get`

Liest mehrere Bereiche aus einer Google Sheets-Tabellenkalkulation in einer einzigen Anfrage

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Ja | Google Sheets-Tabellenkalkulationskennung |
| `ranges` | json | Ja | Array von zu lesenden Bereichen \(z. B. \["Tabelle1!A1:D10", "Tabelle2!A1:B5"\]\). Jeder Bereich sollte den Tabellenblattnamen enthalten. |
| `majorDimension` | string | Nein | Die Hauptdimension der Werte: "ROWS" \(Standard\) oder "COLUMNS" |
| `valueRenderOption` | string | Nein | Wie Werte dargestellt werden sollen: "FORMATTED_VALUE" \(Standard\), "UNFORMATTED_VALUE" oder "FORMULA" |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | Die Tabellenkalkulationskennung |
| `valueRanges` | array | Array von Wertebereichen, die aus der Tabellenkalkulation gelesen wurden |
|   ↳ `range` | string | Der Bereich, der gelesen wurde |
|   ↳ `majorDimension` | string | Hauptdimension \(ROWS oder COLUMNS\) |
|   ↳ `values` | array | Die Zellwerte als 2D-Array |
| `metadata` | json | Tabellenkalkulationsmetadaten einschließlich ID und URL |
|   ↳ `spreadsheetId` | string | Google Sheets-Tabellenkalkulationskennung |
|   ↳ `spreadsheetUrl` | string | Tabellenkalkulations-URL |

### `google_sheets_batch_update`

Mehrere Bereiche in einer Google Sheets-Tabelle in einer einzigen Anfrage aktualisieren

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Ja | Google Sheets-Tabellen-ID |
| `data` | json | Ja | Array von Wertebereichen, die aktualisiert werden sollen. Jedes Element sollte "range" \(z. B. "Sheet1!A1:D10"\) und "values" \(2D-Array\) enthalten. |
| `valueInputOption` | string | Nein | Wie Eingabedaten interpretiert werden sollen: "RAW" oder "USER_ENTERED" \(Standard\). USER_ENTERED analysiert Formeln. |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | Die Tabellen-ID |
| `totalUpdatedRows` | number | Gesamtanzahl der aktualisierten Zeilen |
| `totalUpdatedColumns` | number | Gesamtanzahl der aktualisierten Spalten |
| `totalUpdatedCells` | number | Gesamtanzahl der aktualisierten Zellen |
| `totalUpdatedSheets` | number | Gesamtanzahl der aktualisierten Tabellenblätter |
| `responses` | array | Array von Aktualisierungsantworten für jeden Bereich |
|   ↳ `spreadsheetId` | string | Die Tabellen-ID |
|   ↳ `updatedRange` | string | Der Bereich, der aktualisiert wurde |
|   ↳ `updatedRows` | number | Anzahl der in diesem Bereich aktualisierten Zeilen |
|   ↳ `updatedColumns` | number | Anzahl der in diesem Bereich aktualisierten Spalten |
|   ↳ `updatedCells` | number | Anzahl der in diesem Bereich aktualisierten Zellen |
| `metadata` | json | Tabellenmetadaten einschließlich ID und URL |
|   ↳ `spreadsheetId` | string | Google Sheets-Tabellen-ID |
|   ↳ `spreadsheetUrl` | string | Tabellen-URL |

### `google_sheets_batch_clear`

Mehrere Bereiche in einer Google Sheets-Tabelle mit einer einzigen Anfrage löschen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | ----------- | ------------- |
| `spreadsheetId` | string | Ja | Google Sheets-Tabellen-ID |
| `ranges` | json | Ja | Array der zu löschenden Bereiche (z. B. ["Sheet1!A1:D10", "Sheet2!A1:B5"]). Jeder Bereich muss den Blattnamen enthalten. |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ------------- |
| `spreadsheetId` | string | Die Tabellen-ID |
| `clearedRanges` | array | Array der gelöschten Bereiche |
| `metadata` | json | Tabellenmetadaten einschließlich ID und URL |
|   ↳ `spreadsheetId` | string | Google Sheets-Tabellen-ID |
|   ↳ `spreadsheetUrl` | string | Tabellen-URL |

### `google_sheets_copy_sheet`

Ein Blatt von einer Tabelle in eine andere kopieren

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | ----------- | ------------- |
| `sourceSpreadsheetId` | string | Ja | Quell-Google-Sheets-Tabellen-ID |
| `sheetId` | number | Ja | Die ID des zu kopierenden Blatts (numerische ID, nicht der Blattname). Verwenden Sie "Get Spreadsheet", um Blatt-IDs zu finden. |
| `destinationSpreadsheetId` | string | Ja | Die ID der Zieltabelle, in die das Blatt kopiert wird |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ------------- |
| `sheetId` | number | Die ID des neu erstellten Blatts in der Zieltabelle |
| `title` | string | Der Titel des kopierten Blatts |
| `index` | number | Der Index (Position) des kopierten Blatts |
| `sheetType` | string | Der Typ des Blatts (GRID, CHART usw.) |
| `destinationSpreadsheetId` | string | Die ID der Zieltabelle |
| `destinationSpreadsheetUrl` | string | URL zur Zieltabelle |
