E-tablolar, hücrelerinde bulunan değer verilerinin yanı sıra aşağıdakiler gibi başka birçok veri türü içerir:
- Boyutlar
- Hücre biçimleri ve kenarlıklar
- Adlandırılmış aralıklar
- Korunan aralıklar
- Koşullu biçimlendirme
Bunlar, e-tablonun görünümünü ve çalışmasını kontrol eden birçok veri türünden bazılarıdır. spreadsheets.batchUpdate
yöntemi, bu e-tablo ayrıntılarından herhangi birini güncellemenize olanak tanır. Değişiklikler grup halinde gruplandırılır. Böylece bir istek başarısız olursa diğer (potansiyel olarak bağımlı) değişikliklerin hiçbiri yazılmaz.
Bu sayfada spreadsheets.batchUpdate
yöntemini kullanmayla ilgili temel bilgiler açıklanmaktadır. Hücre değeri verilerini okuyup yazmanız gerekiyorsa Hücre değerlerini okuma ve yazma bölümünde açıklanan spreadsheets.values
kaynağını da kullanabilirsiniz.
İşlem 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 (Yinelenen isteklerde olduğu gibi bazen eskilerini temel alır). |
Güncelle (ve Ayarla) | Bir nesnenin belirli özelliklerini güncelleyerek genellikle eski özellikleri olduğu gibi bırakır (Set isteği önceki verilerin üzerine yazar). |
Sil | Nesneleri kaldırın. |
Bu kategoriler bir sonraki bölümde belirli işlemlerin davranışını açıklamak için kullanılmaktadı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. Aşağıda, farklı kategorilere göre gruplandırılmış istek türlerinin dökümü verilmiştir.
Verileri değiştirmek amacıyla 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ı makaleye göz atın.
Alan maskeleri
"Güncelleme" isteklerinin çoğu alan maskeleri gerektirir. Bunlar, bir nesnedeki yalnızca belirli alanları güncellerken diğer alanları değiştirmeden güncellemek için kullanılan virgülle ayrılmış alanlar listesidir. *
alan maskesi joker karakter gibi değerlendirilir ve bir mesajdaki her alanı belirtmek için kullanılır (istekte kendisi için bir değer belirtmediğiniz takdirde bir alan varsayılan durumuna geri dönebilir).
Alan maskeleri hakkında daha fazla bilgi için Alan maskelerini kullanma başlıklı makaleyi inceleyin.
Aşağıdaki örnekte, yalnızca bir e-tablonun başlığını güncellemek için UpdateSpreadsheetPropertiesRequest
kullanılmıştır:
İstek:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
İstek gövdesi:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
TITLE ifadesinin yerine e-tablonun yeni başlığını yazın.
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ı dizini işleyecek şekilde bir dizi içinde döndürülür. Bazı isteklerde yanıt yok ve bu isteklerde yanıt boş.
Genellikle "add" (ekleme) isteklerinde, eklenen nesnenin kimliği gibi bilgileri döndüren yanıtlar bulunur. Desteklenen yanıtların listesi için Yanıtlar bölümüne bakın.
Örnek
Aşağıdaki kod örneği şu işlemleri gerçekleştirir:
- E-tablonun başlığını
title
değişkenini kullanarak günceller. find
vereplacement
değişkenlerini kullanarak e-tabloda hücre değerlerini bulup değiştirir.