Method: spreadsheets.values.batchClearByDataFilter

E-tablodan bir veya daha fazla değer aralığını temizler. Arayan, e-tablo kimliğini ve bir veya daha fazla DataFilters belirtmelidir. Belirtilen veri filtrelerinden herhangi biriyle eşleşen aralıklar temizlenecek. Yalnızca değerler temizlenir; hücrenin diğer tüm özellikleri (biçimlendirme, veri doğrulama vb.) korunur.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
spreadsheetId

string

Güncellenecek e-tablonun kimliği.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Alanlar
dataFilters[]

object (DataFilter)

Temizlenecek aralıkları belirlemek için kullanılan DataFilters.

Yanıt gövdesi

Bir e-tabloda DataFilters ile seçilen bir değer aralığı temizlendiğinde verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
Alanlar
spreadsheetId

string

Güncellemelerin uygulandığı e-tablo.
clearedRanges[]

string

A1 gösteriminde temizlenen aralıklar. İstekler sınırsız bir aralık ya da sayfanın sınırlarından daha büyük bir aralık için yapılıyorsa bu, temizlenen ve sayfanın sınırlarıyla sınırlı olan gerçek aralıklardır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.