Löscht einen oder mehrere Wertebereiche aus einer Tabelle. Der Anrufer muss die Tabellen-ID und mindestens eine DataFilters
angeben. Bereiche, die mit einem der angegebenen Datenfilter übereinstimmen, werden gelöscht. Es werden nur Werte gelöscht. Alle anderen Eigenschaften der Zelle (z. B. Formatierung, Datenvalidierung usw.) bleiben erhalten.
HTTP-Anfrage
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
spreadsheetId |
Die ID der zu aktualisierenden Tabelle. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"dataFilters": [
{
object ( |
Felder | |
---|---|
dataFilters[] |
|
Antworttext
Die Antwort beim Löschen eines Wertebereichs, der mit DataFilters
in einer Tabelle ausgewählt ist.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
Felder | |
---|---|
spreadsheetId |
Die Tabelle, auf die die Aktualisierungen angewendet wurden. |
clearedRanges[] |
Die Bereiche, die gelöscht wurden, in A1-Notation Wenn sich die Anfragen auf einen unbegrenzten Bereich oder einen Rangbereich beziehen, der größer als die Grenzen des Tabellenblatts ist, sind dies die tatsächlichen Bereiche, die gelöscht wurden und an die Limits des Tabellenblatts gebunden sind. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.