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 die bessere Wahl 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 Revisionen 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:

  • Grundlegendes Lesen: Rezepte, die zeigen, wie Werte aus einem Tabellenblatt gelesen werden.
  • Grundlegendes Schreiben: Rezepte, die zeigen, wie Werte in eine Tabelle 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: Vorlagen, die zeigen, wie sich die Zellenanzeige basierend auf Bedingungen ändern lässt.
  • Datenvorgänge: Rezepte zum Erstellen, Verschieben und Bearbeiten von Daten in einer Tabelle.
  • 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: Rezepte zum Hinzufügen, Entfernen und Verschieben von Zeilen und Spalten sowie zum Aktualisieren ihrer Eigenschaften.
  • Tabellenvorgänge: Rezepte zum Erstellen, Leeren, Kopieren und Löschen von Tabellen sowie zum Verwalten ihrer Eigenschaften.