Method: spreadsheets.values.batchClear

E-tablodan bir veya daha fazla değer aralığını temizler. Çağrıyı yapan kişi, 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ğrulama 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

string

Güncellenecek e-tablonun kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi
{
  "ranges": [
    string
  ]
}
Alanlar
ranges[]

string

A1 gösterimi veya R1C1 gösterimiyle temizlenecek aralıklar.

Yanıt gövdesi

Bir e-tabloda 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

string

Güncellemelerin uygulandığı e-tablo.

clearedRanges[]

string

Temizlenen aralıklar (A1 gösteriminde). İstekler sınırsız bir aralıkla veya sayfanın sınırlarından daha büyük bir korucuyla ilgiliyse bu, sayfanın sınırlarıyla sınırlı olan 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.