Google Sheets API – Übersicht

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

  • 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, jedes mit strukturierten Informationen in Zellen. A Tabellenressource steht für jede Tabelle und enthält eindeutiger 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. A Die Tabellenressource stellt jedes Tabellenblatt dar und enthält 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. Die Zellen sind so angeordnet, Zeilen und Spalten und können als Zellbereich gruppiert werden. A CellData-Ressource stellt jede Zelle dar, aber und keinen eindeutigen ID-Wert haben. Zeile stattdessen und Spaltenkoordinaten die Zellen.

A1-Notation

Syntax, die verwendet wird, um eine Zelle oder einen Zellenbereich mit einer Zeichenfolge zu definieren, die 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 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. Beispielsweise bezieht sich A1 auf die Zelle A1 im ersten sichtbaren Tabellenblatt, während sich A1 auf die Zelle A1 bezieht. auf alle Zellen in einem Blatt namens A1. In ähnlicher Weise bezieht sich Sheet1 auf alle Zellen in Sheet1. Wenn es jedoch einen benannten Bereich mit dem Namen „Sheet1“ gibt, bezieht sich Sheet1 auf den benannten Bereich und auf „Sheet1“. sich auf das Blatt bezieht.
R1C1-Notation

Syntax, die verwendet wird, um eine Zelle oder einen Zellenbereich mit einer Zeichenfolge zu definieren, die 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, wenn auf einen Zellbereich relativ zum Zellbereich einer bestimmten Zelle verwiesen wird. .

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, der vereinfacht werden soll in einer Anwendung. A 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 stellt einen geschützten Bereich dar.

Nächste Schritte

  • Um mehr über die Entwicklung mit Google Workspace APIs zu erfahren, einschließlich der Handhabung von Authentifizierung und Autorisierung, siehe Entwickeln Sie mit Google Workspace.

  • Wie Sie eine einfache Sheets API-App konfigurieren und ausführen, erfahren Sie in der Kurzanleitungen