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 geplante 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 möchten, Folgendes:
- Wenn Sie Zellenwerte lesen oder schreiben müssen, ist die Sammlung
spreadsheets.valueseine bessere Wahl als die Sammlungspreadsheets. Die Oberfläche des Vorgängers 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 zu einem einzigen Methodenaufruf zu bündeln. Die Verwendung dieser Batchmethoden verbessert die Effizienz, da sie:- Reduzieren Sie den HTTP-Aufwand des Clients.
- Reduzieren Sie die Anzahl der Abfragen.
- Reduzieren Sie die Anzahl der Überarbeitungen des Dokuments.
- Stellen Sie die Atomarität aller Änderungen im Batch sicher.
Rezepte
Die in diesem Abschnitt aufgeführten Beispiele zeigen, wie häufige Aktionen in Google Tabellen als Sheets API v4-Anfragen ausgedrückt werden.
Diese Beispiele werden in Form von sprachneutralen HTTP-Anfragen präsentiert. 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.
- Einfaches Schreiben: Rezepte, die zeigen, wie Werte in ein Tabellenblatt geschrieben werden.
- Grundlegende Formatierung: Rezepte, die zeigen, wie Sie das Aussehen von Tabellenblättern und Zellen ändern.
- Diagramme: Schemata, die zeigen, wie Diagramme in einem Tabellenblatt erstellt und geändert werden.
- Bedingte Formatierung: Schemas, die zeigen, wie die Darstellung von Zellen basierend auf bestimmten Bedingungen geändert wird.
- Datenvorgänge: Rezepte, die zeigen, wie Daten in einer Tabelle erstellt, verschoben und bearbeitet werden.
- Benannte und geschützte Bereiche – Schemas, die zeigen, wie benannte und geschützte Bereiche in einer Tabelle erstellt, aktualisiert und entfernt werden.
- Pivot-Tabellen: Rezepte für Pivot-Tabellen in einem Tabellenblatt.
- Zeilen- und Spaltenvorgänge: Schemata, die das Hinzufügen, Entfernen und Verschieben von Zeilen und Spalten sowie das Aktualisieren ihrer Eigenschaften zeigen.
- Tabellenvorgänge: Rezepte, die zeigen, wie Sie Tabellenblätter erstellen, löschen, kopieren und löschen und wie Sie ihre Eigenschaften festlegen.