Google Sheets API – Übersicht

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

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

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

Tabelle

Das primäre Objekt in Google Tabellen, das mehrere Tabellenblätter enthalten kann, jedes mit strukturierten Informationen in Zellen. Eine Tabellenressource steht für jede Tabelle und hat einen eindeutigen spreadsheetId-Wert, der Buchstaben, Ziffern, Bindestriche oder Unterstriche enthält. Sie finden die Tabellen-ID in der 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 und hat einen eindeutigen Titel und einen numerischen Wert für sheetId. Sie finden die Tabellen-ID in der Google Tabellen-URL:

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

Zelle

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

A1-Notation

Syntax zum Definieren einer Zelle oder eines Zellenbereichs mit einer Zeichenfolge, die den Tabellenblattnamen sowie die Anfangs- und Endkoordinaten der Zelle enthält. Dabei werden Spaltenbuchstaben und Zeilennummern verwendet. Diese Methode ist die gängigste und nützlichste Methode, wenn Sie auf einen absoluten Zellenbereich verweisen.

Beispiele anzeigen

  • Sheet1!A1:B2 bezieht sich auf die ersten beiden Zellen in den ersten beiden Zeilen von Sheet1 (Tabellenblatt1).
  • Sheet1!A:A bezieht sich auf alle Zellen in der ersten Spalte von Sheet1 (Tabellenblatt1).
  • Sheet1!1:2 bezieht sich auf alle Zellen in den ersten beiden Zeilen von Sheet1 (Tabellenblatt1).
  • 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 in den ersten beiden Zeilen des ersten sichtbaren Tabellenblatts.
  • Sheet1 bezieht sich auf alle Zellen in Sheet1.
  • 'My Custom Sheet'!A:A bezieht sich auf alle Zellen in der ersten Spalte eines Tabellenblatts namens „Mein benutzerdefiniertes Tabellenblatt“. Einfache Anführungszeichen sind für Tabellenblattnamen erforderlich, die Leerzeichen, Sonderzeichen oder eine alphanumerische Kombination enthalten.
  • 'My Custom Sheet' bezieht sich auf alle Zellen in „Mein benutzerdefiniertes Tabellenblatt“.

Tipp: Verwenden Sie nach Möglichkeit unterschiedliche Namen für die Objekte in Ihren Tabellen. Zum Beispiel bezieht sich A1 auf die Zelle A1 im ersten sichtbaren Tabellenblatt, während sich 'A1' auf alle Zellen in einem Blatt mit dem Namen A1 bezieht. In ähnlicher Weise verweist Sheet1 auf alle Zellen in Sheet1. Wenn es jedoch einen benannten Bereich mit dem Titel „Sheet1“ gibt, bezieht sich „Sheet1“ (Tabellenblatt1) auf den benannten Bereich und „Sheet1“ (Tabellenblatt1) auf das Tabellenblatt.
R1C1-Notation

Syntax zum Definieren einer Zelle oder eines Zellenbereichs mit einer Zeichenfolge, die den Tabellenblattnamen sowie die Anfangs- und Endkoordinaten der Zelle enthält. Dabei werden Zeilennummern und Spaltennummern verwendet. Diese Methode ist weniger verbreitet als die A1-Notation, kann aber nützlich sein, wenn auf einen Zellenbereich relativ zur Position einer bestimmten Zelle verwiesen wird.

Beispiele anzeigen

  • Sheet1!R1C1:R2C2 bezieht sich auf die ersten beiden Zellen in den ersten beiden Zeilen von Sheet1 (Tabellenblatt1).
  • 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 sich drei Zeilen unterhalb und eine Spalte rechts neben der aktuellen Zelle befindet.
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, die bzw. der nicht geändert werden kann. Eine ProtectedRange-Ressource stellt einen geschützten Bereich dar.

Nächste Schritte

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

  • Wie Sie eine einfache Sheets API-Anwendung konfigurieren und ausführen, erfahren Sie in der Kurzanleitung.