Neben den in den Zellen enthaltenen Wertdaten enthält eine Tabelle viele andere Datentypen, z. B.:
- Abmessungen
- Zellformate und Rahmen
- Benannte Bereiche
- Geschützte Bereiche
- Bedingte Formatierung
Dies sind einige der vielen Arten von Daten, die das Aussehen und die Funktionsweise einer Tabelle steuern. Mit der Methode spreadsheets.batchUpdate
können Sie alle diese Tabellendetails aktualisieren. Änderungen werden in einem Batch zusammengefasst. Wenn eine Anfrage fehlschlägt, werden keine der anderen (möglicherweise abhängigen) Änderungen geschrieben.
Auf dieser Seite werden die Grundlagen zur Verwendung der Methode spreadsheets.batchUpdate
beschrieben. Wenn Sie Zellenwertdaten lesen und schreiben müssen, können Sie auch die unter Zellenwerte lesen und schreiben beschriebene Ressource spreadsheets.values
verwenden.
Vorgangskategorien
Die von spreadsheets.batchUpdate
unterstützten Vorgänge lassen sich in die folgenden allgemeinen Kategorien einteilen:
Kategorie | Beschreibung |
---|---|
Hinzufügen (und Duplizieren) | Fügen Sie neue Objekte hinzu (manchmal basierend auf alten Objekten, wie bei Duplicate-Anfragen). |
Aktualisieren (und Festlegen) | Aktualisieren Sie bestimmte Eigenschaften eines Objekts und lassen Sie dabei in der Regel die alten Eigenschaften unverändert (während eine Set-Anfrage die vorherigen Daten überschreibt). |
Löschen | Entfernen Sie Objekte. |
Mit diesen Kategorien wird im nächsten Abschnitt das Verhalten bestimmter Vorgänge beschrieben.
Batch-Aktualisierungsvorgänge
Für die Methode spreadsheets.batchUpdate
werden ein oder mehrere Request-Objekte verwendet, die jeweils eine bestimmte Art von Anfrage definieren. Es gibt viele verschiedene Arten von Anträgen. Hier sehen Sie eine Übersicht über die
Arten von Anträgen, gruppiert in verschiedene
Es gibt auch einige zusätzliche Anfragen, die Nutzeraktionen zur Manipulation von Daten nachahmen:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Limits
Weitere Informationen zu Zellen- und Zeilenlimits in Google Tabellen finden Sie unter In Google Drive speicherbare Dateien.
Feldmasken
Viele der „Update“-Anfragen erfordern Feldmasken. Dies ist eine durch Kommas getrennte Liste von Feldern, um nur bestimmte Felder in einem Objekt zu aktualisieren, während die anderen Felder unverändert bleiben. Eine Feldmaske vom Typ *
wird wie ein Platzhalter behandelt und ist eine Kurzform, mit der alle Felder in einer Nachricht angegeben werden können. Das bedeutet, dass ein Feld in den Standardzustand zurückgesetzt werden kann, wenn Sie in der Anfrage keinen Wert dafür angeben.
Weitere Informationen zu Feldmasken finden Sie unter Feldmasken verwenden.
Im folgenden Beispiel wird mit UpdateSpreadsheetPropertiesRequest
nur der Titel einer Tabelle aktualisiert:
Anfrage:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
Anfragetext:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
Ersetzen Sie TITLE durch den neuen Titel der Tabelle.
Antworten
Beim Aktualisieren einer Tabelle können bei einigen Arten von Anfragen Antworten zurückgegeben werden. Diese werden in einem Array zurückgegeben, wobei jede Antwort denselben Index wie die entsprechende Anfrage belegt. Für einige Anfragen gibt es keine Antworten, bei denen die Antwort leer ist.
In der Regel enthalten Anfragen vom Typ „Hinzufügen“ Antworten, die Informationen wie die ID des hinzugefügten Objekts zurückgeben. Eine Liste der unterstützten Antworten finden Sie unter Antworten.
Beispiel
Im folgenden Codebeispiel werden diese Aktionen ausgeführt:
- Aktualisiert den Titel der Tabelle mit der Variablen
title
. - Sucht und ersetzt Zellenwerte in der Tabelle mithilfe der Variablen
find
undreplacement
.