E-tablolar, hücrelerinde yer alan değer verilerinin yanı sıra aşağıdakiler gibi başka birçok veri türünü de içerir:
- Boyutlar
- Hücre biçimleri ve kenarlıklar
- Adlandırılmış aralıklar
- Korunan aralıklar
- Koşullu biçimlendirme
Bunlar, bir e-tablonun görünümünü ve çalışmasını kontrol eden çeşitli veri türlerinden bazılarıdır. spreadsheets.batchUpdate
yöntemi, bu e-tablo ayrıntılarını
güncellemenize olanak tanır. Değişiklikler toplu olarak gruplandırılır. Böylece, bir istek başarısız olursa diğer (potansiyel olarak bağımlı) değişiklik yazılmaz.
Bu sayfada, spreadsheets.batchUpdate
yönteminin kullanımıyla ilgili temel bilgiler açıklanmaktadır. Hücre değeri verilerini okumanız ve yazmanız gerekiyorsa Hücre değerlerini okuma ve yazma bölümünde açıklanan spreadsheets.values
kaynağını da kullanabilirsiniz.
Çalışma kategorileri
spreadsheets.batchUpdate
tarafından desteklenen belirli işlemler, aşağıdaki geniş kategorilerde gruplandırılabilir:
Kategori | Açıklama |
---|---|
Ekle (ve Kopyala) | Yeni nesneler ekleyin (Bazen Yinelenen isteklerde olduğu gibi eskilerini temel alır). |
Güncelle (ve Ayarla) | Bir nesnenin belirli özelliklerini genellikle eski özellikleri olduğu gibi bırakarak güncelleyin (Ayarlama isteği önceki verilerin üzerine yazar). |
Sil | Nesneleri kaldırma |
Bu kategoriler bir sonraki bölümde belirli işlemlerin davranışını açıklamak için kullanılır.
Toplu güncelleme işlemleri
spreadsheets.batchUpdate
yöntemi, her biri gerçekleştirilecek tek bir istek türünü belirten bir veya daha fazla Request nesnesi alarak çalışır. Birçok farklı
istek türü vardır. Talep türlerinin farklı kategorilere göre
gruplandırılmış bir dökümü aşağıda verilmiştir.
Verileri manipüle etmek için kullanıcı işlemlerini taklit eden bazı ek istekler de vardır:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Sınırlar
Google E-Tablolar'daki hücre ve satır sınırları hakkında daha fazla bilgi edinmek için Google Drive'da depolayabileceğiniz dosyalar başlıklı makaleyi inceleyin.
Alan maskeleri
"Güncelleme" isteklerinin çoğu için alan maskeleri gerekir. Bunlar, diğer alanları değiştirmeden bırakarak bir nesnedeki yalnızca belirli alanları güncellemek için virgülle ayrılmış alanlar listesidir. *
alan maskesi, joker karakter gibi kabul edilir ve bir iletideki her alanı belirtmenin kısaltmasıdır (yani istekte bir değer belirtmezseniz alan varsayılan durumuna geri dönebilir).
Alan maskeleri hakkında daha fazla bilgi için Alan maskelerini kullanma bölümüne bakın.
Aşağıdaki örnekte, bir e-tablonun yalnızca başlığını güncellemek için UpdateSpreadsheetPropertiesRequest
kullanılmaktadır:
İstek:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
İstek içeriği:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
TITLE kısmını e-tablonun yeni başlığıyla değiştirin.
Yanıtlar
Bir e-tabloyu güncellerken bazı istek türleri yanıt döndürebilir. Bunlar, her yanıt karşılık gelen istekle aynı dizine sahip bir dizide döndürülür. Bazı istekler yanıt içermiyor ve bu istekler için yanıt boş.
Genellikle "add" istekleri, eklenen nesnenin kimliği gibi bilgileri döndüren yanıtlar içerir. Desteklenen yanıtların listesi için Yanıtlar bölümüne bakın.
Örnek
Aşağıdaki kod örneğinde şu işlemler yapılır:
title
değişkenini kullanarak e-tablonun başlığını günceller.- E-tablodaki hücre değerlerini
find
vereplacement
değişkenlerini kullanarak bulup değiştirir.