Method: spreadsheets.values.batchClear

Menghapus satu atau beberapa rentang nilai dari spreadsheet. Pemanggil harus menentukan ID spreadsheet dan satu rentang atau lebih. Hanya nilai yang dihapus -- semua properti sel lainnya (seperti format dan validasi data) akan disimpan.

Permintaan HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
spreadsheetId

string

ID spreadsheet yang akan diperbarui.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "ranges": [
    string
  ]
}
Kolom
ranges[]

string

Rentang yang akan dihapus, dalam notasi A1 atau notasi R1C1.

Isi respons

Respons ketika menghapus rentang nilai dalam spreadsheet.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
Kolom
spreadsheetId

string

Spreadsheet yang menerapkan pembaruan tersebut.
clearedRanges[]

string

Rentang yang dihapus, dalam notasi A1. Jika permintaan ditujukan untuk rentang yang tidak terikat atau rentang yang lebih besar dari batas sheet, ini adalah rentang sebenarnya yang dihapus, yang dibatasi oleh batas sheet.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.