Menghapus satu atau beberapa rentang nilai dari spreadsheet. Pemanggil harus menentukan ID spreadsheet dan satu atau beberapa rentang. Hanya nilai yang dihapus -- semua properti lain dari sel (seperti pemformatan 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 |
ID spreadsheet yang akan diperbarui. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "ranges": [ string ] } |
Kolom | |
---|---|
ranges[] |
Rentang yang akan dihapus, dalam notasi A1 atau notasi R1C1. |
Isi respons
Respons saat menghapus rentang nilai dalam spreadsheet.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
Kolom | |
---|---|
spreadsheetId |
Spreadsheet tempat pembaruan diterapkan. |
clearedRanges[] |
Rentang yang dihapus, dalam notasi A1. Jika permintaan adalah untuk rentang tidak terbatas atau rentang yang lebih besar dari batas sheet, ini adalah rentang sebenarnya yang dihapus dan terikat dengan 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 informasi selengkapnya, lihat Panduan otorisasi.