Hücrelerinde bulunan değer verilerinin yanı sıra e-tablo, başka birçok tür içerir. Örneğin:
- Boyutlar
- Hücre biçimleri ve kenarlıklar
- Adlandırılmış aralıklar
- Korunan aralıklar
- Koşullu biçimlendirme
Bunlar, görünüş ve görünüm işlemlerini kontrol eden
işlemi olarak nitelendirilir. spreadsheets.batchUpdate
yöntemiyle yapabilecekleriniz:
bu e-tablo ayrıntılarından herhangi birini güncelleyebilirsiniz. Değişiklikler bir bütün olarak
İsteklerden biri başarısız olursa diğerlerinin hiçbiri (potansiyel olarak bağımlı)
nasıl yazıldığını
öğrendiniz.
Bu sayfada,
spreadsheets.batchUpdate
yöntemidir. Hücre değeri verilerini okumanız ve yazmanız gerekiyorsa, veri kaynağındaki
spreadsheets.values
Okuma ve hücre değerlerini yazın.
Çalışma kategorileri
spreadsheets.batchUpdate
tarafından desteklenen belirli işlemler gruplanabilir.
aşağıdaki geniş kategorileri kapsar:
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 işletmenizin davranışını açıklamak için kullanılır. belirli işlemlerdir.
Toplu güncelleme işlemleri
spreadsheets.batchUpdate
yöntemi, bir veya daha fazla maddeyi dikkate alarak çalışır.
İstek
nesnelerinden her biri, gerçekleştirilecek tek bir istek türünü belirtir. Her biri 100'den az gösterim alan
talep edebilirsiniz. İstek türlerinin dökümü,
grup halinde gruplandırılır.
Manipülasyon amaçlı olarak kullanıcı işlemlerini taklit eden bazı ek istekler de mevcuttur. veri:
- 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 Şu konumda depolayabileceğiniz dosyalar bölümüne bakın: Google Drive'a gidin.
Alan maskeleri
Yapılacak "güncellemenin" büyük bir kısmı alan maskeleri gerektirir. Bunlar virgülle ayrılmış
bir nesnede yalnızca belirli alanları güncellemek için alan listesi
diğer alanlarda değişiklik yapılamaz. *
alan maskesi,
joker karakterdir ve bir iletideki her alanı belirtmenin kısaltmasıdır (yani
bir alan için bir değer belirtmezseniz alan varsayılan durumuna geri dönebilir
ekleyin).
Alan maskeleri hakkında daha fazla bilgi için Kullanım alanı
kullanın.
Aşağıdaki örnekte
UpdateSpreadsheetPropertiesRequest
e-tablonun yalnızca başlığını güncellemek için:
İ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. Bu her yanıt talebinize ekleyebilirsiniz. Bazı istekler yanıt içermiyor ve yanıt boş.
Genellikle, "add" isteklerde kimlik numarası gibi bilgiler döndüren yanıtlar varsa kullanabilirsiniz. Desteklenen yanıtların listesi için bkz. Yanıtlar.
Ö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şken.