Google Sheets API – Übersicht

Die Google Sheets API ist eine RESTful-Schnittstelle, mit der Sie die Daten einer Tabelle lesen und ändern können. Mit der Sheets API haben Sie folgende Möglichkeiten:

  • Tabellen erstellen
  • Werte von Tabellenkalkulationszellen lesen und schreiben
  • Tabellenformatierung aktualisieren
  • Verbundene Tabellenblätter verwalten

Im Folgenden finden Sie eine Liste mit häufig verwendeten Begriffen in der Sheets API:

Tabelle

Das primäre Objekt in Google Sheets. Sie kann mehrere Sheets enthalten, die jeweils strukturierte Informationen in Cells enthalten. Die Ressource spreadsheets stellt eine Tabelle dar. Es enthält einen eindeutigen spreadsheetId-Wert.

Tabellen-ID
Die eindeutige Kennung für eine Tabelle. Es handelt sich um eine bestimmte Zeichenfolge mit Buchstaben, Zahlen und einigen Sonderzeichen, die auf eine Tabelle verweist und aus der URL der Tabelle abgeleitet werden kann. Tabellen-IDs bleiben stabil, auch wenn sich der Tabellenname ändert.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
Sheets

Eine Seite oder ein Tab in einer Tabelle. Die Ressource Sheets stellt ein Tabellenblatt dar. Es enthält einen eindeutigen numerischen sheetId-Wert und das Tabellenblatt title als Teil des SheetProperties-Objekts.

Tabellenblatt-ID
Die eindeutige Kennung für ein bestimmtes Tabellenblatt in einer Tabelle. Es handelt sich um eine bestimmte Ganzzahl mit Zahlen, die auf ein Tabellenblatt verweisen. Sie kann aus der URL der Tabelle abgeleitet werden. Tabellenblatt-IDs bleiben gleich, auch wenn sich der Name des Tabellenblatts ändert. Ein Beispiel finden Sie unter Tabellen-ID.
Cell

Ein einzelnes Text- oder Datenfeld in einem Tabellenblatt. Zellen sind in Zeilen und Spalten angeordnet und können als Zellbereich gruppiert werden. Die Ressource Cells stellt jede Zelle dar, hat aber keinen eindeutigen ID-Wert. Stattdessen werden die Zellen durch Zeilen- und Spaltenkoordinaten identifiziert.

A1-Notation
Eine Syntax zum Definieren einer Zelle oder eines Zellbereichs mit einem String, der den Tabellennamen sowie die Koordinaten der Start- und Endzelle mit Spaltenbuchstaben und Zeilennummern enthält. Diese Methode ist die gängigste und nützlichste, wenn Sie auf einen absoluten Zellbereich verweisen.
  • Sheet1!A1:B2 bezieht sich auf alle Zellen in den ersten beiden Zeilen und Spalten von Sheet1.
  • Sheet1!A:A bezieht sich auf alle Zellen in der ersten Spalte von Sheet1.
  • Sheet1!1:2 bezieht sich auf alle Zellen in den ersten beiden Zeilen von Sheet1.
  • Sheet1!A5:A bezieht sich auf alle Zellen der ersten Spalte von Tabelle 1 ab Zeile 5.
  • A1:B2 bezieht sich auf alle Zellen in den ersten beiden Zeilen und Spalten des ersten sichtbaren Tabellenblatts.
  • Sheet1 bezieht sich auf alle Zellen in Sheet1.
  • 'Jon's_Data'!A1:D5 bezieht sich auf alle Zellen in den ersten fünf Zeilen und vier Spalten eines Blatts mit dem Namen „Jons_Data“.
  • 'My Custom Sheet'!A:A bezieht sich auf alle Zellen in der ersten Spalte eines Arbeitsblatts mit dem Namen „Mein benutzerdefiniertes Arbeitsblatt“.
  • 'My Custom Sheet' bezieht sich auf alle Zellen in „My Custom Sheet“.

Einfache Anführungszeichen sind für Tabellennamen mit Leerzeichen oder Sonderzeichen erforderlich.

Tipp: Verwenden Sie nach Möglichkeit unterschiedliche Namen für Objekte in Ihren Tabellen. A1 (ohne Anführungszeichen) bezieht sich beispielsweise auf Zelle A1 im ersten sichtbaren Tabellenblatt. 'A1' bezieht sich auf ein Tabellenblatt mit dem Namen A1. Entsprechend verweist „Sheet1“ auf ein Tabellenblatt mit dem Namen „Sheet1“. Wenn es jedoch einen benannten Bereich mit dem Titel „Sheet1“ gibt, bezieht sich „Sheet1“ auf den benannten Bereich und 'Sheet1' auf das Tabellenblatt.

R1C1-Notation
Eine Syntax, mit der eine Zelle oder ein Zellbereich mit einem String definiert wird, der den Tabellennamen sowie die Koordinaten der Start- und Endzelle mit Zeilen- und Spaltennummern enthält. Diese Methode ist weniger verbreitet als die A1-Notation, kann aber nützlich sein, wenn Sie auf einen Zellbereich relativ zur Position einer bestimmten Zelle verweisen.
  • Sheet1!R1C1:R2C2 bezieht sich auf die ersten beiden Zellen in den beiden obersten Zeilen von Sheet1.
  • R1C1:R2C2 bezieht sich auf die ersten beiden Zellen in den oberen beiden Zeilen des ersten sichtbaren Blatts.
  • Sheet1!R[3]C[1] bezieht sich auf die Zelle, die sich drei Zeilen unter und eine Spalte rechts von der aktuellen Zelle befindet.
Benannter Bereich
Eine definierte Zelle oder ein definierter Zellenbereich mit einem benutzerdefinierten Namen, um Verweise in einer Anwendung zu vereinfachen. Eine FilterView-Ressource stellt einen benannten Bereich dar.
Geschützter Bereich
Eine definierte Zelle oder ein definierter Zellbereich, die bzw. der nicht geändert werden kann. Eine ProtectedRange-Ressource stellt einen geschützten Bereich dar.

  • Informationen zur Entwicklung mit Google Workspace APIs, einschließlich der Verarbeitung von Authentifizierung und Autorisierung, finden Sie unter Entwicklung mit Google Workspace.

  • Informationen zum Konfigurieren und Ausführen einer Sheets API-App finden Sie in der JavaScript-Kurzanleitung.