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 können Sie:

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

Im Folgenden finden Sie eine Liste häufig verwendeter Begriffe in der Google Tabellen API:

Tabelle

Das primäre Objekt in Google Tabellen. 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 einer Tabelle. Es ist ein bestimmter String, der Buchstaben, Zahlen und einige Sonderzeichen enthält, die auf eine Tabelle verweisen. Er kann aus der URL der Tabelle abgeleitet werden. Tabellen-IDs bleiben gleich, 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.

Tabellen-ID
Die eindeutige Kennung für ein bestimmtes Tabellenblatt innerhalb einer Tabelle. Es ist ein bestimmter String, der Buchstaben, Zahlen und einige Sonderzeichen enthält, die auf ein Tabellenblatt verweisen. Er kann aus der URL der Tabelle abgeleitet werden. Tabellen-IDs bleiben gleich, auch wenn sich der Tabellenname ä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 Zellenbereich gruppiert werden. Die Ressource Cells steht für jede Zelle, 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 Zellenbereichs mit einem String, der den Namen des Tabellenblatts sowie die Koordinaten der Start- und Endzelle mithilfe von Spaltenbuchstaben und Zeilennummern enthält. Diese Methode ist die gängigste und nützlichste, wenn Sie auf einen absoluten Zellenbereich verweisen.

Beispiele anzeigen

  • 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 Tabellenblatt 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 Tabellenblatts namens „Jon's_Data“.
  • 'My Custom Sheet'!A:A bezieht sich auf alle Zellen in der ersten Spalte eines Arbeitsblatts namens „Mein benutzerdefiniertes Arbeitsblatt“.
  • 'My Custom Sheet' bezieht sich auf alle Zellen in „Meine benutzerdefinierte Tabelle“.

Für Tabellennamen mit Leerzeichen, Sonderzeichen oder einer alphanumerischen Kombination sind einfache Anführungszeichen erforderlich.

Tipp: Verwenden Sie nach Möglichkeit eindeutige 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. Ebenso bezieht sich „Tabelle1“ auf eine Tabelle mit dem Namen „Tabelle1“. Wenn es jedoch einen benannten Bereich mit dem Namen „Tabelle1“ gibt, bezieht sich „Tabelle1“ auf den benannten Bereich und 'Sheet1' auf die Tabelle.
R1C1-Notation
Syntax, mit der eine Zelle oder ein Zellenbereich mit einem String definiert wird, der den Tabellennamen sowie die Start- und Endkoordinaten der Zelle mithilfe von Zeilen- und Spaltennummern enthält. Diese Methode ist weniger üblich als die A1-Notation, kann aber nützlich sein, wenn Sie einen Zellenbereich relativ zur Position einer bestimmten Zelle referenzieren möchten.

Beispiele anzeigen

  • Sheet1!R1C1:R2C2 bezieht sich auf die ersten beiden Zellen in den ersten beiden Zeilen von Sheet1.
  • R1C1:R2C2 bezieht sich auf die ersten beiden Zellen in den ersten beiden Zeilen des ersten sichtbaren Tabellenblatts.
  • Sheet1!R[3]C[1] bezieht sich auf die Zelle, die drei Zeilen unterhalb und eine Spalte rechts von der aktuellen Zelle ist.
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 Zellenbereich, der nicht geändert werden kann. Eine ProtectedRange-Ressource stellt einen geschützten Bereich dar.