Google Sheets API – Übersicht

Die Google Sheets API ist eine RESTful-Oberfläche, mit der Sie Tabellenkalkulationen. Die API wird unter anderem so verwendet: Aufgaben:

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

Im Folgenden finden Sie eine Liste der in dieser API verwendeten allgemeinen Begriffe:

Tabelle

Das primäre Objekt in Google Tabellen, das mehrere Tabellenblätter enthalten kann, jedes mit strukturierten Informationen in Zellen. Spreadsheet Ressource steht für alle Tabelle und hat eine eindeutige spreadsheetId-Wert Buchstaben, Ziffern, Bindestriche oder Unterstriche enthalten. Sie finden die Tabellen-ID in einer Google Tabellen-URL:

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

Tabelle

Eine Seite oder ein Tab in einer Tabelle. Sheet Ressource steht für jede Tabelle und hat einen eindeutigen Titel und eine sheetId-Wert. Ich können Sie die Tabellen-ID in einer Google Tabellen-URL ermitteln:

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

Zelle

Ein einzelnes Text- oder Datenfeld in einem Tabellenblatt. Zellen sind in Reihen angeordnet Spalten und können als Zellbereich gruppiert werden. CellData Ressource steht für jede Zelle, die aber keinen eindeutigen ID-Wert hat. Stattdessen werden Zeilen und Spalten um die Zellen zu identifizieren.

A1-Notation
Eine Syntax, mit der eine Zelle oder ein Zellenbereich mit einem String definiert wird, der enthält den Namen des Tabellenblatts sowie die Koordinaten der Start- und Endzelle mithilfe von Spaltenbuchstaben und Zeilennummern. Diese Methode ist am gebräuchlichsten und nützlichsten wenn auf einen absoluten Zellbereich verwiesen wird.

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 mit dem Namen „Jons_Daten“.
  • 'My Custom Sheet'!A:A verweist auf alle Zellen in der ersten Spalte eines Tabellenblatts namens „My Custom Sheet“.
  • 'My Custom Sheet' verweist auf alle Zellen in „Meine benutzerdefinierte Tabelle“.

Für Tabellenblattnamen, die Leerzeichen, Sonderzeichen oder eine alphanumerische Kombination enthalten, sind einfache Anführungszeichen erforderlich.

Tipp: Verwenden Sie nach Möglichkeit unterschiedliche Namen für 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. Ebenso bezieht sich Sheet1 auf alle Zellen in Sheet1. Gibt es jedoch einen benannten Bereich namens „Sheet1“, verweist Sheet1 auf den benannten Bereich und Sheet1 auf das Tabellenblatt.

R1C1-Notation
Eine Syntax, mit der eine Zelle oder ein Zellenbereich mit einem String definiert wird, der enthält den Namen des Tabellenblatts sowie die Koordinaten der Start- und Endzelle mithilfe von Zeilen- und Spaltennummern. Diese Methode ist weniger gebräuchlich als die A1-Notation, kann aber nützlich sein, wenn auf einen Zellbereich relativ zu einem bestimmten Zellenposition ein.

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 dies zu vereinfachen in einer Anwendung. FilterView Ressource steht für einen benannten Bereich.
Geschützter Bereich
Eine definierte Zelle oder ein Zellenbereich, die bzw. der nicht geändert werden kann. A ProtectedRange Ressource steht für einen geschützten Bereich.
  • Um mehr über die Entwicklung mit Google Workspace APIs zu erfahren, einschließlich der Handhabung von finden Sie unter Entwickeln auf Google Workspace

  • Informationen zum Konfigurieren und Ausführen einer Sheets API-App finden Sie in der Kurzanleitungen