Method: spreadsheets.values.batchClearByDataFilter

Menghapus satu atau beberapa rentang nilai dari spreadsheet. Untuk mengetahui informasi selengkapnya, lihat Membaca, menulis, dan menelusuri metadata.

Pemanggil harus menentukan ID spreadsheet dan satu atau beberapa DataFilters. Rentang yang cocok dengan salah satu filter data yang ditentukan akan dihapus. Hanya nilai yang dihapus -- semua properti sel lainnya (seperti pemformatan, validasi data, dll.) tetap dipertahankan.

Permintaan HTTP

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

URL ini 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 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Kolom
dataFilters[]

object (DataFilter)

DataFilters yang digunakan untuk menentukan rentang yang akan dihapus.

Isi respons

Respons saat menghapus rentang nilai yang dipilih dengan DataFilters dalam spreadsheet.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

string

Spreadsheet tempat pembaruan diterapkan.
clearedRanges[]

string

Rentang yang dihapus, dalam notasi A1. Jika permintaan ditujukan untuk rentang yang tidak memiliki batas atau rentang yang lebih besar dari batas sheet, ini adalah rentang sebenarnya yang dihapus, yang dibatasi pada 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.