Google Sheets API

Die Google Sheets API ist eine RESTful-Oberfläche, mit der Sie Daten einer Tabelle lesen und ändern können. Diese API wird am häufigsten für folgende Aufgaben verwendet:

  • Tabellen erstellen
  • Tabellenzellenwerte lesen und schreiben
  • Tabellenformatierung aktualisieren
  • Verbundene Tabellenblätter verwalten

Im Folgenden finden Sie eine Liste gebräuchlicher Begriffe aus der Sheets API:

Tabelle

Das primäre Objekt in Google Tabellen, das mehrere Tabellenblätter enthalten kann, jeweils mit strukturierten Informationen in Zellen. Eine Tabellenressource stellt jede Tabelle dar und hat einen eindeutigen spreadsheetId-Wert, der Buchstaben, Ziffern, Bindestriche oder Unterstriche enthält. Sie finden die Tabellen-ID in einer Google Tabellen-URL:

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

Tabellenblatt

Eine Seite oder ein Tab in einer Tabelle. Eine Tabellenressource stellt jedes Tabellenblatt dar. Sie hat einen eindeutigen Titel und einen numerischen sheetId-Wert. Die Tabellen-ID finden Sie in einer Google Tabellen-URL:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

Zelle

Ein einzelnes Textfeld oder Text in einem Tabellenblatt. Zellen sind in Zeilen und Spalten angeordnet und können als Zellenbereich gruppiert werden. Eine CellData-Ressource stellt jede Zelle dar, hat aber keinen eindeutigen ID-Wert. Stattdessen identifizieren Zeilen- und Spaltenkoordinaten die Zellen.

A1-Notation

Eine Syntax zum Definieren einer Zelle oder eines Zellenbereichs mit einem String, der den Tabellenblattnamen und die Anfangs- und Endzellenkoordinaten in Spaltenbuchstaben und Zeilennummern enthält. Diese Methode ist am gängigsten und nützlich, wenn auf einen absoluten Zellbereich verwiesen wird.

Beispiele anzeigen

  • Sheet1!A1:B2 bezieht sich auf die ersten beiden Zellen in den ersten beiden Zeilen von Tabellenblatt 1.
  • 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 Tabellenblatt 1.
  • Sheet1!A5:A bezieht sich auf alle Zellen der ersten Spalte von Tabellenblatt 1, ab Zeile 5.
  • A1:B2 bezieht sich auf die ersten beiden Zellen der ersten beiden Zeilen des ersten sichtbaren Tabellenblatts.
  • Sheet1 bezieht sich auf alle Zellen in Tabellenblatt 1.
  • 'My Custom Sheet'!A:A bezieht sich auf alle Zellen in der ersten Spalte eines Tabellenblatts namens „My Custom Sheet“. Bei Tabellenblattnamen mit Leerzeichen, Sonderzeichen oder einer alphanumerischen Kombination sind einfache Anführungszeichen erforderlich.
  • 'My Custom Sheet' bezieht sich auf alle Zellen in „Mein benutzerdefiniertes Tabellenblatt“.

Tipp: Verwenden Sie nach Möglichkeit eindeutige Namen für die Objekte in Ihren Tabellen. Beispielsweise bezieht sich A1 auf die Zelle A1 im ersten sichtbaren Tabellenblatt, während sich „A1“ auf alle Zellen in einem Tabellenblatt mit dem Namen A1 bezieht. Ebenso bezieht sich Tabellenblatt1 auf alle Zellen in Tabelle1. Wenn es jedoch einen benannten Bereich mit der Bezeichnung „Tabellenblatt1“ gibt, bezieht sich Tabellenblatt1 auf den benannten Bereich und „Tabellenblatt1“ auf das Tabellenblatt.
R1C1-Notation

Eine Syntax zum Definieren einer Zelle oder eines Zellenbereichs mit einem String, der den Tabellenblattnamen und die Anfangs- und Endzellenkoordinaten in Zeilen- und Spaltennummern enthält. Diese Methode ist weniger verbreitet als A1-Notation, kann jedoch nützlich sein, wenn auf einen Zellenbereich bezogen auf die Position einer bestimmten Zelle verwiesen wird.

Beispiele anzeigen

  • Sheet1!R1C1:R2C2 bezieht sich auf die ersten beiden Zellen in den ersten beiden Zeilen von Tabellenblatt 1.
  • R1C1:R2C2 bezieht sich auf die ersten beiden Zellen der 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 angezeigt wird.
Benannter Bereich

Eine definierte Zelle oder ein 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 Zellenbereich, der nicht geändert werden kann. Eine ProtectedRange-Ressource steht für einen geschützten Bereich.

Nächste Schritte

  • Informationen zum Entwickeln mit Google Workspace APIs, einschließlich der Authentifizierung und Autorisierung, finden Sie unter In Google Workspace entwickeln.

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