E-tablolarda birden fazla sayfa olabilir ve her sayfada istenen sayıda satır olabilir
görebilirsiniz. Hücre,
kesişimini gösterir ve bir veri değeri içerebilir. İlgili içeriği oluşturmak için kullanılan
Google Sheets API sayesinde
spreadsheets.values
okumayı ve yazmayı sağlayan
bir kaynaktır.
Bu sayfada, spreadsheets.values
kaynağının kullanımıyla ilgili temel bilgiler açıklanmaktadır. Eğer
satır eklemeniz veya biçimlendirmeyi ve diğer özellikleri
kullanıyorsanız
spreadsheets.batchUpdate
E-tabloları güncelleme bölümünde açıklanan yöntemden yararlanılır.
Yöntemler
spreadsheets.values
kaynağı
değerleri okuma ve yazmayla ilgili olarak aşağıdaki yöntemleri sunar. Bu yöntemlerin her biri için
belirli bir görev:
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,
Bu artışın ardından, sırasıyla batchGet
ve batchUpdate
yöntemleri (sırasıyla)
birçok proje verisi türü bulunur.
Bu yöntemlerin her birine ilişkin örnekleri Temel okuma ve Temel örnek sayfalar yazma örnek sayfalardır. Tüm örnekleri görmek için şuraya bakın: örneklere genel bakış sayfasına gidin.
Okuma
Bir sayfadaki veri değerlerini okumak için e-tablo kimliğine ve A1
aralığı için gösterimdedir. Aralığı sayfa kimliği olmadan belirtme (A1:B2
)
isteğin e-tablodaki ilk sayfada yürütüldüğü anlamına gelir. Daha fazla
e-tablo kimlikleri ve A1 gösterimi hakkında daha fazla bilgi için Google Sheets API'yi inceleyin.
Genel Bakış.
Çı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ğil.
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şlemleri 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
istek:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Bu isteğe verilen yanıt
ValueRange
nesnesini tanımlayın.
Birden fazla aralığı okuma
Bir e-tablodan birden çok aralıklı değer aralığını okumak için
spreadsheets.values.batchGet
değeri, döndürülecek birkaç aralık belirtmenize olanak tanıyan bir istektir:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Bu isteğe verilen yanıt
BatchGetValuesResponse
spreadsheetId
öğesini ve
ValueRange
nesneler'i tıklayın.
Yazma
Bir sayfaya yazmak için e-tablo kimliğine (A1'deki hücre aralığı) ihtiyacınız vardır ve uygun istek içeriğine yazmak istediğiniz veriler nesnesini tanımlayın. E-tablo kimlikleri ve A1 gösterimi hakkında daha fazla bilgi için bkz. Google Sheets API'ye Genel Bakış.
Güncellemeler için geçerli bir
ValueInputOption
parametresini içerir.
Tekil güncellemeler için zorunlu bir sorgu parametresidir. Toplu güncellemeler için
istek gövdesinde bu parametre zorunludur. ValueInputOption
denetimleri
giriş verilerinin nasıl yorumlanması gerektiği ve giriş dizelerinin ayrıştırıldığı
aşağıdaki tabloda açıklandığı gibi değil:
ValueInputOption |
Açıklama |
---|---|
RAW |
Giriş ayrıştırılmaz ve dize olarak eklenir. Örneğin, "=1+2" girişi "=1+2" formülünü değil, dizeyi yerleştirir dokunun. (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" bir tarih haline gelir ve "=1+2" formül haline gelir. Biçimler de çıkarılabilir.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şlemleri için Temel yazma bölümüne bakın.
Tek bir aralığa yazma
Tek bir aralığa veri yazmak için tek bir aralığa veri yazmak için bir
spreadsheets.values.update
istek:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Güncelleme isteğinin gövdesi,
ValueRange
nesne olacaktır, ancak bu zorunlu tek alan values
olsa da. range
belirtilmişse
URL'deki aralıkla eşleşmelidir. ValueRange
içinde, isteğe bağlı olarak
onun
majorDimension
Varsayılan olarak ROWS
kullanılır. COLUMNS
belirtilirse her bir iç dizi
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 ("").
Birden çok aralık yazma
Birden çok süreksiz aralık yazmak istiyorsanız
spreadsheets.values.batchUpdate
istek:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Toplu güncelleme isteğinin gövdesi,
BatchUpdateValuesRequest
nesne (bir ValueInputOption
ve bir liste örneği)
ValueRange
nesneler (yazılı her aralık için bir adet). Her ValueRange
nesnesi kendi değerini belirtir
range
, majorDimension
ve giriş verileri.
Değer ekleyin
Bir sayfada, veri tablosundan sonra veri eklemek için
spreadsheets.values.append
istek:
Apps Komut Dosyası
Java
JavaScript
Node.js
PHP
Python
Ruby
Güncelleme isteğinin gövdesi,
ValueRange
nesne olacaktır, ancak bu zorunlu tek alan values
olsa da. range
belirtilmişse
URL'deki aralıkla eşleşmelidir. ValueRange
içinde, isteğe bağlı olarak
onun
majorDimension
Varsayılan olarak ROWS
kullanılır. COLUMNS
belirtilirse her bir iç dizi
bir sütuna yazılır.
Giriş aralığı, mevcut verileri aramak ve bir "tablo" bulmak için kullanılır şunun içinde:
görebilirsiniz. Değerler, tablonun bir sonraki satırına,
ilk sütunda yer alır. Örneğin, aşağıdaki gibi görünen Sheet1
örneğini ele alalım:
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
. Eklenen değerler
şu range
girişlerinin tümü için B7
itibarıyla başlar:
Sheet1
olacaktır. Çünkü bu işlem, sayfadaki tüm verileri inceler veB4:D6
konumundaki tablonun son tablo olduğunu bilmeniz gerekiyor.- Her ikisi de
B4:D6
tablosunda yer aldığı içinB4
veyaC5:D5
. - Aralıktaki son tablo
B4:D6
tablosu olduğu içinB2:D4
(ancakA1:C2
tablosunu içermesine rağmen). - Aralıktaki son tablo
B4:D6
tablosu olduğu içinA3:G10
(ö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, belirli bir satırdan sonra mevcut verilerin üzerine yazmak
tablo veya yeni veriler için yeni satırlar ekleyin. Varsayılan olarak giriş, verilerin üzerine yazar
masadan sonra belirir. Yeni verileri yeni satırlara yazmak için
InsertDataOption
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.