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 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, die in der Sheets API verwendet werden:

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 der 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 Zellenbereich gruppiert werden. Eine CellData-Ressource stellt jede Zelle dar, hat jedoch keinen eindeutigen ID-Wert. Stattdessen identifizieren Zeilen- und Spaltenkoordinaten die Zellen.

A1-Notation

Syntax zum Definieren einer Zelle oder eines Zellenbereichs mit einem String, der den Tabellenblattnamen sowie die Anfangs- und Endzellenkoordinaten mit 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 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 ab Zeile 5 auf alle Zellen der ersten Spalte in Tabellenblatt 1.
  • 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 (Tabellenblatt1).
  • 'My Custom Sheet'!A:A bezieht sich auf alle Zellen in der ersten Spalte eines Tabellenblatts namens „Mein benutzerdefiniertes Tabellenblatt“. Für 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 unterschiedliche Namen für die Objekte in Ihren Tabellen. Zum Beispiel bezieht sich A1 auf die Zelle A1 im ersten sichtbaren Blatt, während sich A1 auf alle Zellen in einem Tabellenblatt mit dem Namen A1 bezieht. Sheet1 bezieht sich auf alle Zellen in Sheet1 (Tabellenblatt1). Gibt es jedoch einen benannten Bereich namens „Sheet1“, bezieht sich „Sheet1“ (Tabellenblatt1) auf den benannten Bereich und „Sheet1“ (Tabellenblatt1) auf das Tabellenblatt.

R1C1-Notation

Syntax, die zum Definieren einer Zelle oder eines Zellenbereichs mit einer Zeichenfolge verwendet wird, die den Tabellenblattnamen sowie die Anfangs- und Endkoordinaten der Zellen mithilfe von Zeilennummern und Spaltennummern enthält. 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 der gesamten Anwendung zu vereinfachen. Eine FilterView-Ressource stellt einen benannten Bereich dar.

Geschützter Bereich

Eine definierte Zelle oder ein Zellenbereich, der bzw. der nicht geändert werden kann. Eine ProtectedRange-Ressource stellt einen geschützten Bereich dar.

Nächste Schritte

  • Weitere Informationen zur Entwicklung 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.