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. Es werden nur Werte gelöscht. Alle anderen Eigenschaften der Zelle, wie 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)

Mit dem DataFilters wird festgelegt, welche Bereiche gelöscht werden sollen.

Antworttext

Die Antwort beim Löschen eines mit DataFilters ausgewählten Wertebereichs in einer Tabelle.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

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

string

Tabelle, auf die die Aktualisierungen angewendet wurden
clearedRanges[]

string

Die Bereiche, die gelöscht wurden, in A1-Notation. Wenn die Anfragen einen unbegrenzten Bereich betreffen oder einen Ranger, der größer als die Grenzen des Tabellenblatts ist, sind dies die tatsächlichen Bereiche, die gelöscht wurden und auf die Grenzen des Tabellenblatts begrenzt 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.