Method: spreadsheets.values.batchClear

Löscht einen oder mehrere Wertebereiche aus einer Tabelle. Der Aufrufer muss die Tabellen-ID und einen oder mehrere Bereiche angeben. Es werden nur die 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:batchClear

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die ID der Tabelle, die aktualisiert werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "ranges": [
    string
  ]
}
Felder
ranges[]

string

Die zu löschenden Bereiche in A1-Notation oder R1C1-Notation.

Antworttext

Die Antwort, wenn ein Wertebereich in einer Tabelle 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 Änderungen angewendet wurden.
clearedRanges[]

string

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