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 içeriği
İstek gövdesi aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "ranges": [ string ] } |
Alanlar | |
---|---|
ranges[] |
A1 gösterimi veya R1C1 gösterimi ile temizlenecek aralıklar. |
Yanıt gövdesi
E-tablodaki bir değer aralığını temizlerken 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österiminde temizlenen aralıklar. İstekler sınırsız bir sayfanın veya sayfanın sınırlarından daha büyük bir aralıkla ilgiliyse bu, sayfanın sınırlarıyla sınırlanan 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ılavuzuna bakın.