Google Sheets API – Übersicht

Die Google Sheets API ist eine RESTful-Oberfläche, mit der Sie die Daten einer Tabelle lesen und ändern können. Diese API wird am häufigsten in folgenden Fällen verwendet:

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

Nachfolgend finden Sie eine Liste gebräuchlicher Begriffe, die in der Sheets API verwendet werden:

Tabelle

Das primäre Objekt in Google Tabellen, das mehrere Tabellenblätter enthalten kann, von denen jedes strukturierte Informationen in den Zellen enthält. Eine Tabellesressource steht für jede Tabelle und hat einen eindeutigen spreadsheetId-Wert, der Buchstaben, Ziffern, Bindestriche oder Unterstriche enthält. Die Tabellen-ID finden Sie in einer Google Tabellen-URL:

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

Tabelle

Eine Seite oder ein Tab in einer Tabelle. Eine Tabellenressource stellt jedes Tabellenblatt dar und hat einen eindeutigen Titel und einen numerischen sheetId-Wert. Die Tabellen-ID finden Sie 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 Zellbereich gruppiert werden. Eine CellData-Ressource stellt jede Zelle dar, hat aber keinen eindeutigen ID-Wert. Stattdessen werden die Zellen durch Zeilen- und Spaltenkoordinaten identifiziert.

A1-Notation

Syntax zum Definieren einer Zelle oder eines Zellenbereichs mit einer Zeichenfolge, die den Tabellenblattnamen sowie die Start- und Endzellenkoordinaten mit Spaltenbuchstaben und Zeilennummern enthält. Diese Methode ist am gebräuchlichsten und nützlichsten, wenn Sie auf einen absoluten Zellenbereich verweisen.

Beispiele anzeigen

  • Sheet1!A1:B2 bezieht sich auf die ersten beiden Zellen in den beiden oberen Zeilen 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 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 verweist auf alle Zellen in der ersten Spalte eines Tabellenblatts namens „My Custom Sheet“. Für Tabellenblattnamen, die Leerzeichen, Sonderzeichen oder eine alphanumerische Kombination enthalten, sind einfache Anführungszeichen erforderlich.
  • 'My Custom Sheet' verweist auf alle Zellen in "Meine benutzerdefinierte Tabelle".

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

Syntax zum Definieren einer Zelle oder eines Zellenbereichs mit einer Zeichenfolge, die den Namen des Tabellenblatts sowie die Start- und Endzellenkoordinaten mit Zeilen- und Spaltennummern enthält. Diese Methode ist weniger gebräuchlich als die A1-Notation, kann aber nützlich sein, wenn Sie auf einen Zellenbereich relativ zur Position einer bestimmten Zelle verweisen.

Beispiele anzeigen

  • Sheet1!R1C1:R2C2 bezieht sich auf die ersten beiden Zellen in den beiden oberen 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 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.

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