Bir elektronik tablo, hücrelerinde bulunan değer verilerinin yanı sıra aşağıdakiler gibi birçok başka veri türü içerir:
- Boyutlar
- Hücre biçimleri ve kenarlıkları
- Adlandırılmış aralıklar
- Korumalı aralıklar
- Koşullu biçimlendirme
Bunlar, bir e-tablonun görünümünü ve işleyişini 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, bir istek başarısız olursa diğer (potansiyel olarak bağımlı) değişikliklerin hiçbiri yazılmayacak şekilde toplu olarak gruplandırılır.
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 spreadsheets.values
kaynağını da kullanabilirsiniz. Bu kaynak, Hücre değerlerini okuma ve yazma başlıklı makalede açıklanmıştır.
İşletim 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 ekleme (bazen eski nesnelere dayalı olarak, örneğin yinelenen isteklerde olduğu gibi). |
Güncelleme (ve Ayarlama) | Bir nesnenin belirli özelliklerini güncelleyin. Genellikle eski özellikler olduğu gibi bırakılır (Set isteği ise önceki verilerin üzerine yazar). |
Sil | Nesneleri kaldırın. |
Bu kategoriler, belirli işlemlerin davranışını açıklamak için sonraki bölümde 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ı türde istek vardır. Aşağıda, farklı kategorilerde gruplandırılmış talep türleriyle ilgili bir döküm verilmiştir.
Ayrıca, verileri değiştirmek 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 alan maskesi gerektirir. Bunlar, diğer alanları değiştirmeden bir nesnedeki yalnızca belirli alanları güncellemek için kullanılan, virgülle ayrılmış bir alan listesidir. *
alan maskesi, joker karakter gibi değerlendirilir ve bir iletideki her alanı belirtmek için kullanılan kısaltmadır (bu da istekte bir alan için değer belirtmezseniz alanın varsayılan durumuna dönebileceği anlamına gelir).
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ılmaktadır:
İstek:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
İstek gövdesi:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
TITLE yerine e-tablonun yeni başlığını girin.
Yanıtlar
Bir e-tablo güncellenirken bazı istekler yanıt döndürebilir. Bunlar, her yanıtın ilgili istekle aynı dizini işgal ettiği bir dizide döndürülür. Bazı isteklerin yanıtı yoktur ve bu istekler için yanıt boş olur.
Genellikle "ekle" istekleri, eklenen nesnenin kimliği gibi bilgileri döndüren yanıtlara sahiptir. Desteklenen yanıtların listesi için Yanıtlar başlıklı makaleyi inceleyin.
Örnek
Aşağıdaki kod örneğinde bu işlemler gerçekleştirilir:
title
değişkenini kullanarak e-tablonun başlığını günceller.find
vereplacement
değişkenlerini kullanarak e-tablodaki hücre değerlerini bulur ve değiştirir.