Beispiele

In diesem Abschnitt finden Sie ein Codelab, mit dem Sie sich mit der Google Sheets API vertraut machen können. Außerdem werden eine Reihe von „Rezept“-Beispielen bereitgestellt, die zeigen, wie Sie eine beabsichtigte Google Sheets-Aktion in eine API-Anfrage übersetzen.

Oft gibt es mehr als eine Möglichkeit, eine bestimmte Aufgabe mit der API zu erledigen. Wenn Sie sich für eine bestimmte Vorgehensweise entscheiden, sollten Sie Folgendes beachten:

  • Wenn Sie Zellwerte lesen oder schreiben müssen, ist die spreadsheets.values Sammlung eine bessere Wahl als die spreadsheets Sammlung. Die Schnittstelle der ersteren 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 sie:

    • den HTTP-Overhead des Clients reduzieren.
    • die Anzahl der Anfragen reduzieren.
    • die Anzahl der Überarbeitungen im Dokument reduzieren.
    • die Atomizität aller Änderungen im Batch gewährleisten.

Rezepte

Die in diesem Abschnitt aufgeführten Beispiele zeigen, wie Sie häufige Aktionen in Google Sheets als Anfragen an die Sheets API v4 ausdrücken.

Diese Beispiele werden in Form von HTTP-Anfragen dargestellt, um sprachneutral zu sein. Informationen zum Implementieren von Protokollen für Sheets API-Anfragen in einer bestimmten Sprache mit Google API-Clientbibliotheken finden Sie in den Leitfäden Zellwerte lesen und schreiben und Tabellen aktualisieren.

Die Rezepte in diesem Abschnitt sind in folgende Kategorien unterteilt:

  • Grundlegendes Lesen: Rezepte, die zeigen, wie Sie Werte aus einem Tabellenblatt lesen.
  • Grundlegendes Schreiben: Rezepte, die zeigen, wie Sie Werte in ein Tabellenblatt schreiben.
  • Grundlegende Formatierung: Rezepte , die zeigen, wie Sie das Erscheinungsbild von Tabellenblättern und Zellen ändern.
  • Diagramme: Rezepte, die zeigen, wie Sie Diagramme in einem Tabellenblatt erstellen und ändern.
  • Bedingte Formatierung— Rezepte, die zeigen, wie Sie das Erscheinungsbild 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: Rezepte, die zeigen, wie Sie benannte und geschützte Bereiche in einer Tabelle erstellen, aktualisieren und entfernen.
  • Pivot-Tabellen: Rezepte , die zeigen, wie Sie Pivot-Tabellen in einem Tabellenblatt erstellen.
  • Zeilen- und Spalten vorgänge: Rezepte, die zeigen, wie Sie Zeilen und Spalten hinzufügen, entfernen und verschieben und ihre Eigenschaften aktualisieren.
  • Tabellenblattvorgänge: Rezepte, die zeigen, wie Sie Tabellenblätter erstellen, leeren, kopieren und löschen und ihre Eigenschaften steuern.