Method: spreadsheets.values.clear

Löscht Werte aus einer Tabelle. Der Aufrufer muss die Tabellen-ID und den Bereich angeben. Es werden nur die Werte 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

string

Die ID der Tabelle, die aktualisiert werden soll.
range

string

Die A1-Notation oder R1C1-Notation der Werte, die gelöscht werden sollen.

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

string

Die Tabelle, auf die die Änderungen angewendet wurden.
clearedRange

string

Der Bereich (in A1-Notation), der gelöscht wurde. Wenn die Anfrage auf einen unbegrenzten Bereich oder einen Bereich bezogen war, der größer als die Grenzen des Tabellenblatts ist, ist dies der tatsächliche Bereich, der gelöscht wurde, 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.