E-tablolarda birden çok sayfa olabilir. Bu sayfaların her birinde herhangi bir sayıda satır veya sütun olabilir. Hücre, belirli bir satır ve sütunun kesişimindeki konumdur ve bir veri değeri içerebilir. Google Sheets API, değerlerin okunmasını ve yazılmasını sağlamak için spreadsheets.values
kaynağını sağlar.
Bu sayfada, spreadsheets.values
kaynağının kullanımıyla ilgili temel bilgiler açıklanmaktadır. Bir sayfadaki satırları eklemeniz veya 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ğı, her biri belirli bir görev için olan değerleri okuma ve yazmayla ilgili aşağıdaki yöntemleri sunar:
Aralık Erişimi | Okuma | Yazım |
---|---|---|
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 daha iyi bir fikirdir.
Bu yöntemlerin her birine dair örnekleri 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ığın A1 notasyonuna ihtiyacınız vardır. Aralığın sayfa kimliği (A1:B2
) olmadan belirtilmesi, 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 Sheets API'ye Genel Bakış sayfasına göz atın.
Çıkış biçimini, isteğe bağlı birkaç sorgu parametresi kontrol eder:
Biçim Parametresi | Varsayılan Değer |
---|---|
majorDimension |
SATIRSAY |
valueRenderOption |
FORMATTED_VALUE |
dateTimeRenderOption |
SERIAL_NUMBER |
dateTimeRenderOption
öğesini yalnızca valueRenderOption
FORMATTED_VALUE
değilse kullanmanız gerektiğini unutmayın.
Döndürülen veri miktarına ilişkin 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şlemi örnekleri için Temel okuma bölümüne bakın.
Tek bir aralığı okuma
Bir e-tablodan tek bir değer aralığını okumak için spreadsheets.values.get
isteğini kullanın:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Bu isteğin yanıtı ValueRange
nesnesi olarak döndürülür.
Birden çok aralığı okuma
Bir e-tablodan birden fazla süreksiz değer aralığını okumak için, alınacak birkaç aralık belirtmenizi sağlayan bir spreadsheets.values.batchGet
isteği kullanın:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Bu isteğin yanıtı, spreadsheetId
öğesini ve ValueRange
nesnelerinin listesini içeren bir BatchGetValuesResponse
nesnesi olarak döndürülür.
Yaz
Bir sayfaya yazmak için e-tablo kimliğine, A1 gösterimindeki hücre aralığına ve uygun bir istek gövde nesnesine yazmak istediğiniz verilere ihtiyacınız vardır. E-tablo kimlikleri ve A1 gösterimi hakkında daha fazla bilgi için Google Sheets API'ye Genel Bakış bölümüne bakın.
Güncellemeler için geçerli bir ValueInputOption
parametresi gerekir.
Tekil güncellemeler için zorunlu bir sorgu parametresidir. Toplu güncellemeler için bu parametre, istek gövdesinde gereklidir. 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ılar gibi dize olmayan değerler her zaman RAW olarak işlenir.) |
USER_ENTERED |
Giriş, tam olarak E-Tablolar kullanıcı arayüzüne girildiği gibi ayrıştırılır. Örneğin, "1 Mart 2016" tarih haline, "=1+2" ise formül haline gelir. Biçimler de tahmin edilebilir.Dolayısıyla "$100,15", para birimi biçimlendirmesine sahip bir sayı haline gelir. |
Tekil ve toplu güncelleme yöntemleri aşağıda açıklanmıştır. Temel yazma işlemlerinin örnekleri için Temel yazma bölümüne bakın.
Tek bir aralığa yazma
Tek bir aralığa 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, ValueRange
nesnesi olmalıdır. Bununla birlikte, zorunlu olan tek alan values
alanıdır. range
belirtilmişse URL'deki aralıkla eşleşmesi gerekir. ValueRange
içinde isteğe bağlı olarak majorDimension
öğesini belirtebilirsiniz.
Varsayılan olarak ROWS
kullanılır. COLUMNS
belirtilirse her iç dizi, satır yerine bir 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 sürekli olmayan aralık yazmak istiyorsanız spreadsheets.values.batchUpdate
isteğini kullanabilirsiniz:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Toplu güncelleme isteğinin gövdesi, ValueInputOption
ve ValueRange
nesnelerinin (yazılı her aralık için bir adet) listesini içeren bir BatchUpdateValuesRequest
nesnesi olmalıdır. Her ValueRange
nesnesi kendi range
, majorDimension
ve giriş verilerini belirtir.
Değer ekleyin
Bir sayfadaki veri tablosundan sonra 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, ValueRange
nesnesi olmalıdır. Bununla birlikte, zorunlu olan tek alan values
alanıdır. range
belirtilmişse URL'deki aralıkla eşleşmesi gerekir. ValueRange
içinde isteğe bağlı olarak majorDimension
öğesini belirtebilirsiniz.
Varsayılan olarak ROWS
kullanılır. COLUMNS
belirtilirse her iç dizi, satır yerine bir sütuna yazılır.
Giriş aralığı, mevcut verileri aramak ve bu aralık içinde 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, aşağıdaki gibi görünen Sheet1
örneğini ele alalım:
CEVAP | B | C | G | 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
. Eklenen değerler, aşağıdaki tüm range
girişleri için B7
itibarıyla başlar:
Sheet1
, çünkü sayfadaki tüm verileri inceler veB4:D6
konumundaki tablonun son tablo olduğunu belirler.- Her ikisi de
B4:D6
tablosunda yer aldığı içinB4
veyaC5:D5
. B2:D4
; aralıktaki son tabloB4:D6
tablosu olduğu için (A1:C2
tablosunu da içermesine rağmen)B2:D4
.A3:G10
, aralıktaki son tabloB4:D6
tablosu olduğu için (öncesinde başlayıp sonra bitse bile).
Aşağıdaki range
girişleri B7
itibarıyla yazmaya başlamadı:
A1
,A1:C2
tablosunda olduğu içinA3
itibarıyla yazmaya başlar.E4
, herhangi bir tabloda olmadığı içinE4
olduğunda yazmaya başlar. (A4
, aynı nedenlerden dolayıA4
itibarıyla yazmaya da başlar.)
Ayrıca, bir tablodan sonra mevcut verilerin üzerine yazmak veya yeni veriler için yeni satırlar eklemek isteyip istemediğinizi seçebilirsiniz. Varsayılan olarak giriş, tablodan sonraki verilerin üzerine yazar. Yeni verileri yeni satırlara yazmak için InsertDataOption
öğesini 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.