Menghapus satu atau beberapa rentang nilai dari spreadsheet. Pemanggil harus menentukan ID spreadsheet dan satu atau beberapa DataFilters
. Rentang yang cocok dengan filter data yang ditentukan akan dihapus. Hanya nilai yang dihapus -- semua properti sel lainnya (seperti pemformatan, validasi data, dll.) yang disimpan.
Permintaan HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
spreadsheetId |
ID spreadsheet yang akan diperbarui. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"dataFilters": [
{
object ( |
Kolom | |
---|---|
dataFilters[] |
|
Isi respons
Respons saat menghapus rentang nilai yang dipilih dengan DataFilters
di spreadsheet.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
Kolom | |
---|---|
spreadsheetId |
Spreadsheet yang menerapkan pembaruan tersebut. |
clearedRanges[] |
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.