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 übersetzen.

Häufig gibt es mehrere Möglichkeiten, eine bestimmte Aufgabe mit der API zu erledigen. Wenn Sie entscheiden, wie Sie eine Aufgabe angehen, sollten Sie Folgendes beachten:

  • Wenn Sie Zellwerte lesen oder schreiben müssen, ist die Sammlung spreadsheets.values eine bessere Wahl als die Sammlung spreadsheets. Die Benutzeroberfläche der ersten Option 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. Die Verwendung dieser Batchmethoden verbessert die Effizienz, da:

    • HTTP-Overhead des Clients reduzieren.
    • Reduzieren Sie die Anzahl der ausgeführten Abfragen.
    • Reduzieren Sie die Anzahl der Überarbeitungen im Dokument.
    • Sorgen Sie für die Atomizität aller Änderungen im Batch.

Rezepte

Die in diesem Abschnitt aufgeführten Beispiele zeigen, wie Sie gängige Aktionen in Google Tabellen als Sheets API v4-Anfragen ausdrücken.

Diese Beispiele werden in Form von HTTP-Anfragen präsentiert, um sprachneutral zu sein. Informationen zum Implementieren von Sheets API-Anfrageprotokollen in einer bestimmten Sprache mit Google API-Clientbibliotheken finden Sie in den Anleitungen Zellwerte lesen und schreiben und Tabellen aktualisieren.

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

  • Einfaches Lesen: Rezepte, die zeigen, wie Werte aus einem Tabellenblatt gelesen werden.
  • Einfaches Schreiben: Rezepte, in denen gezeigt wird, wie Werte in ein Tabellenblatt geschrieben werden.
  • Einfache Formatierung: Rezepte, die zeigen, wie das Aussehen von Tabellen und Zellen geändert werden kann.
  • Diagramme: Rezepte, die zeigen, wie Sie Diagramme in einem Tabellenblatt erstellen und ändern.
  • Bedingte Formatierung: Rezepte, die zeigen, wie die Darstellung von Zellen basierend auf Bedingungen geändert wird.
  • Datenvorgänge: Rezepte, in denen gezeigt wird, wie Daten in einer Tabelle erstellt, verschoben und bearbeitet werden.
  • Benannte und geschützte Bereiche: Rezepte, die zeigen, wie benannte und geschützte Bereiche in einer Tabelle erstellt, aktualisiert und entfernt werden.
  • Pivot-Tabellen: Rezepte, in denen beschrieben wird, wie Sie Pivot-Tabellen in einem Tabellenblatt erstellen.
  • Zeilen- und Spaltenvorgänge: Rezepte, in denen gezeigt wird, wie Sie Zeilen und Spalten hinzufügen, entfernen und verschieben und ihre Eigenschaften aktualisieren.
  • Tabellenblattvorgänge: Rezepte, in denen gezeigt wird, wie Tabellenblätter erstellt, gelöscht, kopiert und gelöscht werden und wie ihre Eigenschaften gesteuert werden.