Neben den in den Zellen enthaltenen Wertdaten enthält eine Tabelle viele andere Datentypen, z. B.:
- Abmessungen
- Zellenformate und Rahmen
- Benannte Bereiche
- Geschützte Bereiche
- Bedingte Formatierung
Dies sind einige der vielen Arten von Daten, die das Aussehen und den Betrieb einer Tabelle steuern. Mit der Methode spreadsheets.batchUpdate
können Sie alle diese Tabellendetails aktualisieren. Änderungen werden in einem Batch gruppiert. Wenn eine Anfrage nicht erfolgreich ist, werden keine (potenziell abhängigen) Änderungen geschrieben.
Auf dieser Seite werden die Grundlagen der Verwendung der Methode spreadsheets.batchUpdate
beschrieben. Wenn Sie Zellenwertdaten lesen und schreiben müssen, können Sie auch die Ressource spreadsheets.values
verwenden, die unter Zellenwerte lesen und schreiben beschrieben wird.
Einsatzkategorien
Die von spreadsheets.batchUpdate
unterstützten Vorgänge können in die folgenden allgemeinen Kategorien eingeordnet werden:
Kategorie | Beschreibung |
---|---|
Add (und Duplizieren) | Neue Objekte hinzufügen (manchmal auf Basis alter Objekte, wie bei doppelten Anfragen). |
Aktualisieren (und Festlegen) | Bestimmte Eigenschaften eines Objekts aktualisieren, wobei die alten Eigenschaften normalerweise unverändert bleiben (während eine Set-Anfrage die vorherigen Daten überschreibt) |
Löschen | Objekte entfernen |
Diese Kategorien werden im nächsten Abschnitt verwendet, um das Verhalten bestimmter Vorgänge zu beschreiben.
Batch-Update-Vorgänge
Die Methode spreadsheets.batchUpdate
verwendet ein oder mehrere Request-Objekte, von denen jedes eine bestimmte Art von auszuführenden Anfrage angibt. Es gibt viele verschiedene Arten von Anträgen. Hier sehen Sie die Arten von Anträgen,
gruppiert in verschiedene Kategorien.
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
Für viele Aktualisierungsanfragen sind Feldmasken erforderlich. Dies ist eine durch Kommas getrennte Liste von Feldern, mit denen nur bestimmte Felder in einem Objekt aktualisiert werden. Die anderen Felder bleiben unverändert. Die Feldmaske *
wird wie ein Platzhalter behandelt und ist eine Abkürzung für die Angabe jedes Felds in einer Nachricht. Das bedeutet, dass ein Feld auf seinen 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 geben einige Arten von Anfragen möglicherweise Antworten zurück. Diese werden in einem Array zurückgegeben, wobei jede Antwort denselben Index wie die entsprechende Anfrage enthält. Für einige Anfragen gibt es keine Antworten. Bei anderen ist die Antwort leer.
In der Regel erhalten Anfragen vom Typ "Hinzufügen" mithilfe von Antworten Informationen wie die ID des hinzugefügten Objekts. 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
. - Findet und ersetzt Zellenwerte in der Tabelle mit den Variablen
find
undreplacement
.