In diesem Abschnitt finden Sie ein Codelab, mit dem Sie sich mit der Google Sheets API vertraut machen können. Außerdem finden Sie eine Reihe von Rezeptbeispielen, die zeigen, wie eine beabsichtigte Google Tabellen-Aktion in eine API-Anfrage übersetzt wird.
Häufig gibt es mehrere Möglichkeiten, eine Aufgabe mit der API auszuführen. Beachten Sie bei der Entscheidung, wie Sie eine Aufgabe angehen, Folgendes:
- Wenn Sie Zellenwerte lesen oder schreiben müssen, ist die Sammlung
spreadsheets.valuesdie bessere Wahl als die Sammlungspreadsheets. Die bisherige Schnittstelle 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 zu bündeln. Diese Batchmethoden verbessern die Effizienz, da sie:- Reduzieren Sie den HTTP-Overhead des Clients.
- Reduzieren Sie die Anzahl der Abfragen.
- Reduzieren Sie die Anzahl der Überarbeitungen des Dokuments.
- Achten Sie darauf, dass alle Änderungen im Batch unteilbar sind.
Rezepte
Die in diesem Abschnitt aufgeführten Beispiele zeigen, wie häufige Aktionen in Google Tabellen als Anfragen an die Sheets API Version 4 ausgedrückt werden können.
Diese Beispiele werden in Form von HTTP-Anfragen dargestellt, um sprachneutral zu sein. Informationen zum Implementieren von Sheets API-Anfrageprotokollen in einer bestimmten Sprache mithilfe von Google API-Clientbibliotheken finden Sie in den Leitfäden Zellenwerte lesen und schreiben und Tabellen aktualisieren.
Die Rezepte in diesem Abschnitt sind in folgende Kategorien unterteilt:
- Grundlegende Lesematerialien: Rezepte, die zeigen, wie Werte aus einem Tabellenblatt gelesen werden.
- Grundlegendes Schreiben: Rezepte, die zeigen, wie Werte in ein Tabellenblatt geschrieben werden.
- Grundlegende Formatierung: Rezepte, in denen gezeigt wird, wie sich die Darstellung von Tabellenblättern und Zellen ändern lässt.
- Diagramme: Rezepte, die zeigen, wie Diagramme in einem Tabellenblatt erstellt und geändert werden.
- Bedingte Formatierung: Rezepte, die zeigen, wie die Darstellung von Zellen basierend auf Bedingungen geändert wird.
- Datenvorgänge: Rezepte, die zeigen, wie Daten in einer Tabelle erstellt, verschoben und bearbeitet werden.
- Benannte und geschützte Bereiche: Rezepte, in denen gezeigt wird, wie benannte und geschützte Bereiche in einer Tabelle erstellt, aktualisiert und entfernt werden.
- Pivot-Tabellen: Rezepte, in denen zu sehen ist, wie Pivot-Tabellen in einem Tabellenblatt erstellt werden.
- Zeilen- und Spaltenvorgänge: Rezepte, in denen gezeigt wird, wie Zeilen und Spalten hinzugefügt, entfernt und verschoben sowie deren Eigenschaften aktualisiert werden.
- Tabellenvorgänge: Rezepte, in denen zu sehen ist, wie Tabellenblätter erstellt, gelöscht, kopiert und gelöscht werden, und wie ihre Eigenschaften festgelegt werden.