E-tablolarda, her sayfada istenilen sayıda satır veya sütun olacak şekilde birden fazla sayfa bulunabilir. Hücre, belirli bir satır ile sütunun kesişiminde bulunan bir 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 sayfaya satır eklemeniz veya 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 okuma ve yazmayla ilgili olarak, her biri belirli bir görev için geçerli olacak aşağıdaki yöntemleri sağlar:
Menzil 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 sırasıyla batchGet
ve batchUpdate
yöntemleriyle birleştirmek, verimliliği artırmak için iyi bir fikirdir.
Bu yöntemlerin her birine ilişkin ö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 aralık için e-tablo kimliğine ve A1 gösterimine ihtiyacınız vardır. Aralığın sayfa kimliği (A1:B2
) olmadan belirtilmesi, isteğin e-tablodaki ilk sayfada yürütüldüğü 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.
Bazı isteğe bağlı sorgu parametreleri çıkışın biçimini 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ı için açık bir sınır yoktur. Hatalar veri döndürmez. Sondaki boş satırlar 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ık 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ğe verilen yanıt ValueRange
nesnesi olarak döndürülür.
Birden fazla aralığı okuma
Bir e-tablodan birden çok, sürekli olmayan değer aralığını okumak için, alınacak çeşitli aralıkları belirtmenizi sağlayan bir spreadsheets.values.batchGet
isteği kullanın:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Bu isteğe verilen yanıt, spreadsheetId
öğesini 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ö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 E-Tablolar API'sine Genel Bakış bölümüne bakın.
Güncellemeler için geçerli bir ValueInputOption
parametresi gerekir.
Tekil güncellemeler için gerekli 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ılmadığını kontrol eder:
ValueInputOption |
Açıklama |
---|---|
RAW |
Giriş ayrıştırılmaz ve dize olarak eklenir. Örneğin, "=1+2" girdisi, "=1+2" formülünü değil, dizeyi hücreye yerleştirir. (Boole'lar 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 girilmiş gibi ayrıştırılır. Örneğin, "1 Mart 2016" tarih, "=1+2" ise formül haline gelir. Biçimler de tahmin edilebilir.Böylece, "100,15 ABD doları", 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şlemi örnekleri için Temel yazma bölümüne bakın.
Tek bir aralığa yazma
Tek bir aralığa veri yazmak için bir spreadsheets.values.update
isteği kullanın:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Tek zorunlu alan values
olsa da güncelleme isteğinin gövdesi bir ValueRange
nesnesi olmalıdır. range
belirtilirse URL'deki aralıkla eşleşmelidir. ValueRange
bölümünde isteğe bağlı olarak majorDimension
değerini 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 aralık yazmak istiyorsanız bir spreadsheets.values.batchUpdate
isteği kullanabilirsiniz:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Toplu güncelleme isteğinin gövdesi, ValueInputOption
ve ValueRange
nesnelerinin bir listesini (yazılı her 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 ekle
Bir sayfadaki veri tablosundan sonra veri eklemek için spreadsheets.values.append
isteğini kullanın:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Tek zorunlu alan values
olsa da güncelleme isteğinin gövdesi bir ValueRange
nesnesi olmalıdır. range
belirtilirse URL'deki aralıkla eşleşmelidir. ValueRange
bölümünde isteğe bağlı olarak majorDimension
değerini 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çindeki bir "tablo"yu bulmak için kullanılır. Değerler, tablonun ilk sütunundan başlayarak tablonun sonraki satırına eklenir. Örneğin, aşağıdaki gibi görünen bir Sheet1
örneği düşünün:
CEVAP | 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 var: A1:C2
ve B4:D6
. Eklenen değerler, aşağıdaki range
girişlerinin tümü için B7
ile başlar:
Sheet1
, çünkü sayfadaki tüm verileri inceler veB4:D6
adresindeki tablonun son tablo olduğunu belirler.B4
veyaC5:D5
, çünkü her ikisi deB4:D6
tablosunda yer alıyor.B2:D4
aralığını belirtir, çünkü aralıktaki son tablo,A1:C2
tablosunu içermesine rağmen yineB4:D6
tablosudur.- Aralıktaki son tablo
B4:D6
tablosu olduğu içinA3:G10
değerine sahiptir (öncesinde başlayıp sonrasında bitmesine rağmen).
Şu range
giriş B7
saatinde yazılmaya başlamıyor:
A1
,A1:C2
tablosunda olduğundanA3
itibarıyla yazmaya başlar.E4
hiçbir tabloda olmadığı içinE4
itibarıyla yazmaya başlayacak. (A4
de aynı nedenlerleA4
tarihinde yazmaya başlar.)
Ayrıca, bir tablodan sonra mevcut verilerin üzerine yazmak veya yeni veriler için yeni satırlar eklemek isteyip istemediğinizi de seçebilirsiniz. Giriş, varsayılan olarak tablodan sonra verilerin üzerine yazılır. 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ı makaleye göz atın.