Bir 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 (ör. biçimlendirme ve veri doğrulama) 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 metni
İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
|---|
{ "ranges": [ string ] } |
| Alanlar | |
|---|---|
ranges[] |
Temizlenecek aralıklar, A1 gösterimi veya R1C1 gösterimi. |
Yanıt metni
E-tablodaki 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 |
Güncellemelerin uygulandığı e-tablo. |
clearedRanges[] |
Temizlenen aralıklar (A1 gösterimi). İ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/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheets
Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.