Löscht einen oder mehrere Wertebereiche aus einer Tabelle. Der Aufrufer muss die Tabellen-ID und einen oder mehrere Bereiche angeben. Nur Werte werden 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 |
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-Schreibweise oder R1C1-Schreibweise. |
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 |
Die Tabelle, auf die die Aktualisierungen angewendet wurden. |
clearedRanges[] |
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.