Beispiele

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 „Rezept“-Beispielen, die zeigen, wie Sie eine beabsichtigte Google Tabellen-Aktion in eine API-Anfrage umwandeln.

Oft gibt es mehrere Möglichkeiten, eine bestimmte Aufgabe mit der API auszuführen. Berücksichtigen Sie bei der Entscheidung, wie Sie eine Aufgabe angehen, Folgendes:

  • Wenn Sie Zellenwerte lesen oder schreiben möchten, ist die Sammlung spreadsheets.values besser geeignet als die Sammlung spreadsheets. Die Benutzeroberfläche des ersten ist für einfache Lese-/Schreibvorgänge einfacher zu verwenden.

  • Verwenden Sie nach Möglichkeit die Batchmethoden (spreadsheet.batchUpdate, spreadsheet.values.batchGet und spreadsheet.values.batchUpdate), um mehrere Anfragen in einem einzigen Methodenaufruf zu bündeln. Mit diesen Batchmethoden lässt sich die Effizienz verbessern, da sie:

    • HTTP-Overhead des Clients reduzieren
    • Reduzieren Sie die Anzahl der Abfragen.
    • Reduzieren Sie die Anzahl der Überarbeitungen im Dokument.
    • Sorgen Sie dafür, dass alle Änderungen im Batch atomar sind.

Rezepte

In den Beispielen in diesem Abschnitt wird gezeigt, wie Sie gängige Aktionen in Google Tabellen als Sheets API V4-Anfragen ausdrücken.

Diese Beispiele werden in Form von HTTP-Anfragen dargestellt, um sprachenunabhängig zu sein. Informationen zum Implementieren von Sheets API-Anfrageprotokollen in einer bestimmten Sprache mithilfe von Google API-Clientbibliotheken finden Sie in den Anleitungen Zellenwerte lesen und schreiben und Tabellen aktualisieren.

Die Rezepte in diesem Abschnitt sind in die folgenden Kategorien unterteilt:

  • Grundlegende Lesevorgänge: 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, die zeigen, wie Sie das Aussehen von Tabellen und Zellen ändern.
  • Diagramme: Rezepte zum Erstellen und Ändern von Diagrammen in einer Tabelle.
  • Bedingte Formatierung: Mithilfe von Vorlagen können Sie die Darstellung von Zellen basierend auf Bedingungen ändern.
  • Datenvorgänge: Rezepte, die zeigen, wie Sie Daten in einer Tabelle erstellen, verschieben und bearbeiten.
  • Benannte und geschützte Bereiche: Hier erfahren Sie, wie Sie benannte und geschützte Bereiche in einer Tabelle erstellen, aktualisieren und entfernen.
  • Pivot-Tabellen: Rezepte, die zeigen, wie Sie Pivot-Tabellen in einer Tabelle erstellen.
  • Zeilen- und Spaltenvorgänge: Hier erfahren Sie, wie Sie Zeilen und Spalten hinzufügen, entfernen und verschieben und ihre Eigenschaften aktualisieren.
  • Tabellenvorgänge: Rezepte zum Erstellen, Leeren, Kopieren und Löschen von Tabellen sowie zum Verwalten ihrer Eigenschaften.