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 ein eindeutigesspreadsheetId
-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 einesheetId
-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 Zellenbereich 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 sichSheet1
auf alle Zellen in Sheet1. Gibt es jedoch einen benannten Bereich mit der Bezeichnung „Sheet1“, verweist Sheet1 auf den benannten Bereich undSheet1
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.
Weitere Informationen
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