Method: spreadsheets.values.batchClearByDataFilter

Bir e-tablodaki bir veya daha fazla değer aralığını temizler. Daha fazla bilgi için Meta verileri okuma, yazma ve arama başlıklı makaleyi inceleyin.

Arayan, e-tablo kimliğini ve bir veya daha fazla DataFilters belirtmelidir. Belirtilen veri filtrelerinden herhangi biriyle eşleşen aralıklar temizlenir. Yalnızca değerler temizlenir. Hücrenin diğer tüm özellikleri (ör. 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 metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

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

object (DataFilter)

Hangi aralıkların temizleneceğini belirlemek için kullanılan DataFilters.

Yanıt metni

Elektronik tabloda DataFilters ile seçilen bir değer aralığı temizlenirken 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

Temizlenen aralıklar, A1 gösteriminde. İstekler sınırsız bir aralık veya sayfanın sınırlarından daha büyük bir aralık içinse bu, sayfanın sınırlarıyla sınırlanmış, temizlenen 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ılavuzu'na bakın.