Google Sheets

Diese Anleitung zeigt dir, wie du mithilfe der Google Sheets API automatisiert Daten in eine Google-Tabelle schreibst – z. B. um einzelne Zellen oder ganze Bereiche zu aktualisieren. Das ist nützlich für Berichte, Skripte, Integrationen oder Datenautomatisierungen.

---

🧰 Voraussetzungen

Bevor du Daten in ein Google Sheet schreiben kannst, benötigst du:

• Ein Google Cloud-Projekt

• Einen Service Account

• Die Google Sheets API muss aktiviert sein

• Der Service Account muss Zugriff auf das gewünschte Sheet haben

🔑 Service Account freigeben

1. Öffne das gewünschte Google Sheet.

2. Klicke auf Teilen.

3. Füge die E-Mail-Adresse deines Service Accounts hinzu (z. B. [email protected]).

4. Vergib die Berechtigung „Editor“ oder „Bearbeiter“, damit die API Schreibrechte erhält.

Ohne die Freigabe für den Service Account kann keine Schreibanfrage ausgeführt werden. Achte darauf, dass du die richtige E-Mail-Adresse des Service Accounts verwendest.

---

✏️ Zellen oder Bereiche beschreiben

1. Spreadsheet-ID ermitteln

Die Spreadsheet-ID findest du in der URL deines Google Sheets: https://docs.google.com/spreadsheets/d/1XYZabc1234567/edit

➡️ Spreadsheet-ID: 1XYZabc1234567

2. Beispiel-Request – Werte in Zellen schreiben

Mit dem folgenden Beispiel kannst du Werte in den Bereich A2:B2 eines Sheets schreiben.

PUT https://sheets.googleapis.com/v4/spreadsheets/1XYZabc1234567/values/Sheet1!A2:B2?valueInputOption=RAW
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "range": "Sheet1!A2:B2",
  "majorDimension": "ROWS",
  "values": [
    ["Max Mustermann", "Musterstraße 123"]
  ]
}

Der Parameter valueInputOption=RAW sorgt dafür, dass die Werte unformatiert (ohne Berechnungen oder Formeln) in die Zellen geschrieben werden. Wenn du Excel-ähnliche Formeln verwenden möchtest, nutze stattdessen valueInputOption=USER_ENTERED.

---

🔄 Alternative: Bereich aktualisieren

Du kannst auch ganze Bereiche überschreiben, z. B. mehrere Zeilen oder Spalten gleichzeitig. Ändere dazu einfach den Bereich im Request (z. B. Sheet1!A2:D5) und passe das JSON-Array entsprechend an.

Nutze majorDimension: "COLUMNS", wenn du Spaltenweise statt Zeilenweise Daten einfügen möchtest.

---

✅ Ergebnis

Nach erfolgreichem Request gibt die API eine Bestätigung im JSON-Format zurück, z. B.:

{
  "spreadsheetId": "1XYZabc1234567",
  "updatedRange": "Sheet1!A2:B2",
  "updatedRows": 1,
  "updatedColumns": 2,
  "updatedCells": 2
}

Deine Google-Tabelle wurde erfolgreich über die API aktualisiert! Du kannst diesen Prozess in Skripten, Automatisierungen oder Integrations-Workflows wiederverwenden.