E-tablolarda birden fazla sayfa bulunabilir. Her sayfada ise istediğiniz sayıda satır veya sütun olabilir. Hücre, belirli bir satır ve sütunun kesişimindeki bir konumdur ve veri değeri içerebilir. Google Sheets API, değerlerin okunmasını ve yazılmasını sağlayan spreadsheets.values
kaynağını sağlar.
Bu sayfada, spreadsheets.values
kaynağının temel kullanım bilgileri açıklanmaktadır. Satır eklemeniz veya bir sayfadaki biçimlendirmeyi ve diğer özellikleri güncellemeniz gerekiyorsa E-tabloları güncelleme bölümünde açıklanan spreadsheets.batchUpdate
yöntemini kullanmanız gerekir.
Yöntemler
spreadsheets.values
kaynağı, değerleri okumak ve yazmak için her biri belirli bir göreve yönelik aşağıdaki yöntemleri sağlar:
Aralık erişimi | Okuma | Yazma |
---|---|---|
Tek aralık | spreadsheets.values.get |
spreadsheets.values.update |
Birden fazla aralık | spreadsheets.values.batchGet |
spreadsheets.values.batchUpdate |
Ekleme | spreadsheets.values.append |
Genel olarak, birden fazla okuma veya güncellemeyi batchGet
ve batchUpdate
yöntemleriyle (sırasıyla) birleştirmek iyi bir fikirdir. Bu, verimliliği artırır.
Bu yöntemlerin her birinin örneklerini Temel okuma ve Temel yazma örnekleri sayfalarında bulabilirsiniz. Tüm örnekleri görmek için örneklere genel bakış sayfasına bakın.
Okuma
Bir sayfadaki veri değerlerini okumak için e-tablo kimliğine ve aralık için A1 gösterimine ihtiyacınız vardır. Aralığı sayfa kimliği olmadan (A1:B2
) belirtmek, isteğin e-tablodaki ilk sayfada yürütüleceği anlamına gelir. E-tablo kimlikleri ve A1 gösterimi hakkında daha fazla bilgi için Google E-Tablolar API'ye Genel Bakış başlıklı makaleyi inceleyin.
Çıktının biçimini çeşitli isteğe bağlı sorgu parametreleri kontrol eder:
Biçim Parametresi | Varsayılan değer |
---|---|
majorDimension |
SATIRLAR |
valueRenderOption |
FORMATTED_VALUE |
dateTimeRenderOption |
SERIAL_NUMBER |
dateTimeRenderOption
değerini yalnızca valueRenderOption
FORMATTED_VALUE
değilse kullanmanız gerektiğini unutmayın.
Döndürülen veri miktarıyla ilgili açık bir sınır yoktur. Hatalar veri döndürmez. Sonraki boş satır ve sütunlar atlanır.
Tekil ve toplu alma yöntemleri aşağıda açıklanmıştır. Temel okuma işlemlerine ait örnekler için Temel okuma başlıklı makaleyi inceleyin.
Tek bir aralığı okuma
E-tablodan tek bir değer aralığını okumak için spreadsheets.values.get
isteğinde bulunun:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Bu isteğe verilen yanıt, ValueRange
nesnesi olarak döndürülür.
Birden çok aralığı okuma
Bir e-tablodan birden fazla, kesintisiz olmayan değer aralığını okumak için, alınacak birkaç aralığı belirtmenize olanak tanıyan bir spreadsheets.values.batchGet
isteği kullanın:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Bu isteğin yanıtı, spreadsheetId
ve ValueRange
nesnelerinin listesini içeren bir BatchGetValuesResponse
nesnesi olarak döndürülür.
Yazma
Bir sayfaya yazmak için e-tablo kimliğine, A1 gösterimindeki hücre aralığına ve uygun bir istek gövdesi nesnesi içinde yazmak istediğiniz verilere ihtiyacınız vardır. E-tablo kimlikleri ve A1 gösterimi hakkında daha fazla bilgi için Google E-Tablolar API'ye Genel Bakış başlıklı makaleyi inceleyin.
Güncellemeler için geçerli bir ValueInputOption
parametresi gerekir.
Tekil güncellemeler için bu zorunlu bir sorgu parametresidir. Toplu güncellemeler için bu parametrenin istek gövdesinde bulunması gerekir. ValueInputOption
, aşağıdaki tabloda açıklandığı gibi giriş verilerinin nasıl yorumlanacağını ve giriş dizelerinin ayrıştırılıp ayrıştırılmayacağını kontrol eder:
ValueInputOption |
Açıklama |
---|---|
RAW |
Giriş ayrıştırılmaz ve dize olarak eklenir. Örneğin, "=1+2" girişi hücreye "=1+2" formülünü değil, dizeyi yerleştirir. (Boole veya sayı gibi dize olmayan değerler her zaman RAW olarak işlenir.) |
USER_ENTERED |
Giriş, tam olarak E-Tablolar kullanıcı arayüzüne girmiş gibi ayrıştırılır. Örneğin, "1 Mart 2016" bir tarihe, "=1+2" ise bir formüle dönüşür. Biçim de çıkarılabilir.Böylece "$100,15", para birimi biçimlendirmesine sahip bir sayı olur. |
Tekil ve toplu güncelleme yöntemleri aşağıda açıklanmıştır. Temel yazma işlemleri örnekleri için Temel yazma başlıklı makaleyi inceleyin.
Tek bir alana yazma
Tek bir alana veri yazmak için spreadsheets.values.update
isteği kullanın:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Güncelleme isteğinin gövdesi bir ValueRange
olmalıdır ancak tek zorunlu alan values
'dır. range
belirtilirse URL'deki aralıkla eşleşmelidir. ValueRange
içinde isteğe bağlı olarak majorDimension
değerini belirtebilirsiniz.
Varsayılan olarak ROWS
kullanılır. COLUMNS
belirtilirse her iç dizi satır yerine sütuna yazılır.
Güncelleme sırasında veri içermeyen değerler atlanır. Verileri temizlemek için boş bir dize ("") kullanın.
Birden çok aralık yazma
Birden çok kesintisiz aralık yazmak istiyorsanız spreadsheets.values.batchUpdate
isteği kullanabilirsiniz:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Toplu güncelleme isteğinin gövdesi, bir ValueInputOption
ve ValueRange
nesnelerinin listesini (her yazılı aralık için bir tane) içeren bir BatchUpdateValuesRequest
nesnesi olmalıdır. Her ValueRange
nesnesi kendi range
, majorDimension
ve giriş verilerini belirtir.
Değer ekleme
Bir e-tablodaki veri tablosunun sonuna veri eklemek için spreadsheets.values.append
isteği kullanın:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Güncelleme isteğinin gövdesi bir ValueRange
olmalıdır ancak tek zorunlu alan values
'dır. range
belirtilirse URL'deki aralıkla eşleşmelidir. ValueRange
içinde isteğe bağlı olarak majorDimension
değerini belirtebilirsiniz.
Varsayılan olarak ROWS
kullanılır. COLUMNS
belirtilirse her iç dizi satır yerine sütuna yazılır.
Giriş aralığı, mevcut verileri aramak ve bu aralıkta bir "tablo" bulmak için kullanılır. Değerler, tablonun ilk sütunundan başlayarak tablonun bir sonraki satırına eklenir. Örneğin, şuna benzeyen Sheet1
değerini düşünün:
A | B | C | D | E | |
1 | x | y | z | ||
2 | x | y | z | ||
3 | |||||
4 | x | y | |||
5 | y | z | |||
6 | x | y | z | ||
7 |
Sayfada 2 tablo vardır: A1:C2
ve B4:D6
. Eklenecek değerler, aşağıdaki tüm range
girişleri için B7
ile başlar:
Sheet1
, çünkü e-tablodaki tüm verileri inceler veB4:D6
'teki tablonun son tablo olduğunu belirler.B4
veyaC5:D5
, çünkü her ikisi deB4:D6
tablosundadır.B2:D4
, çünkü aralıktaki son tabloB4:D6
tablosudur (A1:C2
tablosunu da içermesine rağmen).A3:G10
, çünkü aralıktaki son tabloB4:D6
tablosudur (bundan önce başlamasına ve sonrasında bitmesine rağmen).
Aşağıdaki range
girişleri B7
tarihinde yazmaya başlamadı:
A1
,A1:C2
tablosunda olduğu içinA3
adresinden yazmaya başlar.E4
, herhangi bir tabloda olmadığı içinE4
adresinden yazmaya başlar. (A4
de aynı nedenlerleA4
tarihinde yazmaya başlar.)
Ayrıca, bir tablodan sonra mevcut verilerin üzerine mi yazmak istediğinizi yoksa yeni veriler için yeni satırlar mı eklemek istediğinizi seçebilirsiniz. Varsayılan olarak giriş, tablodan sonraki verilerin üzerine yazar. Yeni verileri yeni satırlara yazmak için InsertDataOption
kullanın ve insertDataOption=INSERT_ROWS
değerini belirtin.
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.