Method: spreadsheets.values.batchClearByDataFilter

Löscht einen oder mehrere Wertebereiche aus einer Tabelle. Der Aufrufer muss die Tabellen-ID und mindestens eine DataFilters angeben. Bereiche, die einem der angegebenen Datenfilter entsprechen, werden gelöscht. Nur Werte werden 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

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, wenn in einer Tabelle ein mit DataFilters ausgewählter Wertebereich gelöscht wird.

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-Schreibweise. Wenn sich die Anfragen auf einen unbegrenzten Bereich oder einen Ranger beziehen, der größer als die Grenzen des Tabellenblatts ist, sind dies die tatsächlichen Bereiche, die gelöscht wurden, begrenzt auf die Grenzwerte des Tabellenblatts.

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.