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.

Oft 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 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 Anfragen an die Google Sheets API v4 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, in denen gezeigt wird, wie Werte aus einem Tabellenblatt gelesen werden.
  • Einfaches Schreiben: Rezepte, in denen gezeigt wird, wie Werte in ein Tabellenblatt geschrieben werden.
  • Grundlegende Formatierung: Rezepte, die zeigen, wie das Aussehen von Tabellen und Zellen geändert wird.
  • 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 Sie Tabellenblätter erstellen, leeren, kopieren und löschen und deren Eigenschaften steuern.