Dieser Abschnitt enthält ein Codelab, mit dem Sie sich mit der Google Sheets API vertraut machen können. Außerdem gibt es mehrere Beispiele für Rezepte, die veranschaulichen, wie eine beabsichtigte Google Tabellen-Aktion in eine API-Anfrage umgewandelt wird.
Häufig gibt es mehrere Möglichkeiten, eine bestimmte Aufgabe mit der API auszuführen. Berücksichtigen Sie Folgendes, wenn Sie sich entscheiden, wie Sie eine Aufgabe angehen:
- Wenn Sie Zellenwerte lesen oder schreiben müssen, ist die Sammlung
spreadsheets.valueseine bessere Wahl als die Sammlungspreadsheets. Die frühere Benutzeroberfläche ist für einfache Lese-/Schreibvorgänge einfacher zu verwenden. Verwenden Sie nach Möglichkeit die Batchmethoden (
spreadsheet.batchUpdate,spreadsheet.values.batchGetundspreadsheet.values.batchUpdate), um mehrere Anfragen in einem einzigen Methodenaufruf zusammenzufassen. Diese Batchmethoden verbessern die Effizienz, wenn sie:- Reduzieren Sie den HTTP-Client-Overhead.
- Verringern Sie die Anzahl der Abfragen.
- Reduzieren Sie die Anzahl der Überarbeitungen für das Dokument.
- Atomarität aller Änderungen im Batch sicherstellen.
Rezepte
In den in diesem Abschnitt aufgeführten Beispielen sehen Sie, wie sich häufige Aktionen in Google Tabellen als Anfragen an die Sheets API V4 festlegen lassen.
Diese Beispiele sind sprachneutral in HTTP-Anfragen. Weitere Informationen zum Implementieren von Sheets API-Anfrageprotokollen in einer bestimmten Sprache mithilfe der Google API-Clientbibliotheken finden Sie unter Zellenwerte lesen und schreiben sowie Tabellen aktualisieren.
Die Rezepte in diesem Abschnitt sind in folgende Kategorien unterteilt:
- Grundlegendes Lesen: Rezepte, die zeigen, wie Werte aus einem Tabellenblatt gelesen werden.
- Grundlegendes Schreiben: Rezepte, in denen gezeigt wird, wie Werte in ein Tabellenblatt geschrieben werden.
- Grundlegende Formatierung: Rezepte, in denen gezeigt wird, wie die Darstellung von Tabellenblättern und Zellen geändert werden kann.
- Diagramme: Rezepte, in denen Diagramme in einer Tabelle erstellt und geändert werden.
- Bedingte Formatierung: Rezepte, in denen gezeigt wird, wie die Darstellung der Zellen basierend auf den Bedingungen geändert wird.
- Datenvorgänge: Rezepte, in denen gezeigt wird, wie Sie Daten in einer Tabelle erstellen, verschieben und bearbeiten.
- Benannte und geschützte Bereiche: Rezepte, in denen benannte und geschützte Bereiche in einer Tabelle erstellt, aktualisiert und entfernt werden.
- Pivot-Tabellen: Rezepte, in denen gezeigt wird, wie Pivot-Tabellen in einem Tabellenblatt erstellt werden.
- Zeilen- und Spaltenvorgänge: Rezepte, in denen Zeilen und Spalten hinzugefügt, entfernt und verschoben sowie ihre Eigenschaften aktualisiert werden.
- Tabellenvorgänge: Rezepte, in denen gezeigt wird, wie Sie Tabellenblätter erstellen, löschen, kopieren und löschen sowie ihre Eigenschaften steuern.