Method: spreadsheets.values.batchClearByDataFilter

Löscht Werte aus einem oder mehreren Bereichen einer Tabelle. Weitere Informationen finden Sie unter Metadaten lesen, schreiben und durchsuchen.

Der Aufrufer muss die Tabellen-ID und mindestens einen 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 und Datenvalidierung, 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

string

Die ID der zu aktualisierenden Tabelle.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Felder
dataFilters[]

object (DataFilter)

Die DataFilters, mit der bestimmt wird, welche Bereiche gelöscht werden sollen.

Antworttext

Die Antwort beim Löschen eines Wertebereichs, der mit DataFilters in einer Tabelle ausgewählt wurde.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
Felder
spreadsheetId

string

Die Tabelle, auf die die Aktualisierungen angewendet wurden.
clearedRanges[]

string

Die gelöschten Bereiche in A1-Notation. Wenn die Anfragen für einen unbegrenzten Bereich oder einen Bereich, der größer als die Grenzen des Blatts ist, gelten, sind dies die tatsächlichen Bereiche, die gelöscht wurden, begrenzt auf die Grenzen des Blatts.

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 Autorisierungsleitfaden.