E-tablodaki bir veya daha fazla değer aralığını temizler. Arayan, e-tablo kimliğini ve bir veya daha fazla aralığı belirtmelidir. Yalnızca değerler temizlenir. Hücrenin diğer tüm özellikleri (biçimlendirme ve veri doğrulaması gibi) korunur.
HTTP isteği
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler | |
|---|---|
spreadsheetId | 
                
                   
 Güncellenecek e-tablonun kimliği.  | 
              
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi | 
|---|
{ "ranges": [ string ] }  | 
                
| Alanlar | |
|---|---|
ranges[] | 
                  
                     
 A1 notasyonu veya R1C1 notasyonu biçiminde, temizlenecek aralıklar.  | 
                
Yanıt gövdesi
E-tabloda 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 | 
                    
                       
 Güncellemelerin uygulandığı e-tablo.  | 
                  
clearedRanges[] | 
                    
                       
 A1 gösterimindeki temizlenen aralıklar. İstekler sınırsız bir aralık veya sayfanın sınırlarından daha büyük bir aralık içinse bunlar, sayfanın sınırlarına bağlı olarak temizlenen gerçek aralıklardır.  | 
                  
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheets
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.