Method: spreadsheets.values.clear

Löscht Werte aus einer Tabelle. Der Anrufer muss die Tabellen-ID und den Bereich angeben. Es werden nur 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/{range}:clear

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die ID der zu aktualisierenden Tabelle.
range

string

Die A1-Notation oder R1C1-Notation der zu löschenden Werte.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwort beim Löschen eines Bereichs von Werten in einer Tabelle.

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 Aktualisierungen angewendet wurden.
clearedRange

string

Der Bereich (in A1-Notation), der gelöscht wurde. Wenn die Anfrage für einen unbegrenzten Bereich oder einen Bereich, der größer als die Grenzen des Blatts ist, gestellt wurde, ist dies der tatsächliche Bereich, der gelöscht wurde und der auf die Grenzen des Blatts beschränkt 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 Autorisierungsleitfaden.