Abgesehen von den in den Zellen enthaltenen Wertdaten wird ein Tabelle enthält viele andere Typen von Daten wie:
- Dimensionen
- Zellformate und Rahmen
- Benannte Bereiche
- Geschützte Bereiche
- Bedingte Formatierung
Dies sind einige der vielen Arten von Daten,
die das Erscheinungsbild und
Funktionsweise einer Tabellenkalkulation. Mit der Methode spreadsheets.batchUpdate
können Sie
alle diese Tabellendetails aktualisieren. Änderungen werden im Batch gruppiert,
Wenn eine Anfrage nicht erfolgreich ist, keine der anderen (potenziell abhängigen Anfragen)
Änderungen geschrieben werden.
Auf dieser Seite werden die Grundlagen zur Verwendung des
spreadsheets.batchUpdate
. Wenn Sie Zellenwertdaten lesen und schreiben müssen, können Sie auch den
spreadsheets.values
Ressource unter Lesen und Zellenwerte schreiben.
Vorgangskategorien
Die von spreadsheets.batchUpdate
unterstützten Vorgänge können gruppiert werden
in folgende allgemeine Kategorien eingeordnet werden:
Kategorie | Beschreibung |
---|---|
Hinzufügen (und Duplizieren) | Neue Objekte hinzufügen (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 von für bestimmte Vorgänge.
Batch-Aktualisierungsvorgänge
Für die Methode spreadsheets.batchUpdate
werden ein oder mehrere
Anfrage
-Objekte, die jeweils eine bestimmte Art von auszuführender Anfrage definieren. Es gibt
viele verschiedene Arten von Anträgen. Hier ist eine Übersicht über die
Arten von Anträgen:
verschiedenen Kategorien zugeordnet.
Es gibt auch einige zusätzliche Anforderungen, die Nutzeraktionen nachahmen, um Daten:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Limits
Weitere Informationen zu Zellen- und Zeilenlimits in Google Tabellen finden Sie unter Dateien, die Sie in Google Drive
Feldmasken
Viele der „Update“- Für Anfragen sind Feldmasken erforderlich. Dabei handelt es sich um durch Kommas getrennte
Liste von Feldern, um nur bestimmte Felder in einem Objekt zu aktualisieren, während das
andere Felder unverändert lassen. Die Feldmaske *
wird wie
Platzhalter und steht für die Angabe jedes Felds in einer Nachricht (d. h.,
ein Feld kann auf den Standardwert zurückgesetzt werden, wenn Sie in
der Anfrage).
Weitere Informationen zu Feldmasken finden Sie unter Feld verwenden
Masken.
Im folgenden Beispiel wird die Methode
UpdateSpreadsheetPropertiesRequest
, um nur den Titel einer Tabelle zu aktualisieren:
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 der entsprechenden Anfrage. Für einige Anfragen gibt es keine Antworten. Antwort ist leer.
Üblicherweise „add“ Anfragen haben Antworten, die Informationen wie die ID zurückgeben 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 mithilfe von
find
undreplacement
Variablen.