Löscht Werte aus einer Tabelle. Der Aufrufer muss die Tabellen-ID und den Bereich angeben. 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/{range}:clear
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
spreadsheetId |
Die ID der zu aktualisierenden Tabelle. |
range |
Die A1-Notation oder R1C1-Notation der zu löschenden Werte. |
Anfragetext
Der Anfragetext muss leer sein.
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, "clearedRange": string } |
Felder | |
---|---|
spreadsheetId |
Die Tabelle, auf die die Aktualisierungen angewendet wurden. |
clearedRange |
Der Bereich (in A1-Schreibweise), der gelöscht wurde. Wenn sich die Anfrage auf einen unbegrenzten Bereich oder einen Ranger bezieht, der größer als die Grenzen des Tabellenblatts ist, ist dies der tatsächliche Bereich, der gelöscht wurde und auf die Beschränkungen des Tabellenblatts begrenzt ist. |
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.