Löscht einen oder mehrere Wertebereiche aus einer Tabelle. Der Aufrufer muss die Tabellen-ID und mindestens einen Bereich angeben. Es werden nur Werte gelöscht. Alle anderen Eigenschaften der Zelle, wie 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 |
Die ID der zu aktualisierenden Tabelle. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "ranges": [ string ] } |
Felder | |
---|---|
ranges[] |
Die zu löschenden Bereiche in A1- oder R1C1-Notation. |
Antworttext
Die Antwort beim Löschen eines Wertebereichs in einer Tabellenkalkulation.
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
Felder | |
---|---|
spreadsheetId |
Tabelle, auf die die Aktualisierungen angewendet wurden |
clearedRanges[] |
Die bereinigten Bereiche 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.