Google Sheets API; hücrelerden, aralıklardan, aralık kümelerinden ve sayfaların tamamından değerleri okumanıza olanak tanır. Bu sayfadaki örnekler, spreadsheets.values
kaynağıyla yapılan bazı yaygın okuma işlemlerini göstermektedir. Hücre değerlerini spreadsheets.get
yöntemini kullanarak da okuyabilirsiniz ancak spreadsheets.values.get
veya spreadsheets.values.batchGet
daha kolaydır.
Bu örnekler, dilden bağımsız olarak HTTP istekleri şeklinde sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde okuma işlemlerini nasıl uygulayacağınızı öğrenmek için Hücre değerlerini okuma ve yazma bölümüne bakın.
Bu örneklerde SPREADSHEET_ID yer tutucusu, e-tablo URL'sinden bulunabilen e-tablo kimliğini nerede sağlayacağınızı belirtir. Okunacak aralıklar, istek URL'sinde A1 gösterimi kullanılarak belirtilir. Sayfa1!A1:D5 gibi bir aralık örnek verilebilir.
Kaynak veriler
Bu örneklerde, okunmakta olan e-tablonun ilk sayfasında ("Sayfa1") aşağıdaki kaynak verilerin bulunduğunu varsayalım. İlk satırdaki dizeler, bağımsız sütunlara ilişkin etiketlerdir. E-tablonuzdaki diğer sayfalardaki bilgileri nasıl okuyacağınıza dair örnekleri görmek için A1 gösterimine bakın.
CEVAP | B | C | G | |
1 | Öğe | Maliyet | Stokta | Gönderim Tarihi |
2 | Dönme dolap | 20,50 TL | 4 | 01.03.2016 |
3 | Kapı | Hong Kong doları | 2 | 15.03.2016 |
4 | Motor | Hong Kong doları | 1 | 20.03.2016 |
5 | Toplam | 135,5 TL | 7 | 20.03.2016 |
Tek bir aralığı okuma
Aşağıdaki spreadsheets.values.get
kod örneğinde, Sheet1!A1:D5 aralığındaki değerlerin nasıl okunacağı gösterilmektedir. Bu değerler, yanıtta döndürülmektedir. Sonraki boş satır ve sütunlar atlanır.
İstek protokolü burada gösterilir.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5
Yanıt, aralık değerlerini açıklayan bir ValueRange
nesnesinden oluşur. majorDimension
alanı, dizilerin satırlara göre düzenlenen değer listeleri olduğunu gösterir.
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "3/1/2016"], ["Door", "$15", "2", "3/15/2016"], ["Engine", "$100", "1", "30/20/2016"], ["Totals", "$135.5", "7", "3/20/2016"] ], }
Sütuna göre gruplandırılmış tek bir aralığı okuma
Aşağıdaki spreadsheets.values.get
kod örneğinde, Sheet1!A1:D3 aralığındaki değerlerin nasıl okunacağı gösterilmektedir. Bu değerler, yanıtta ancak sütuna göre gruplanmış şekilde nasıl döndürülecektir. Sondaki boş satır ve sütunlar yoksayılır.
İstek protokolü burada gösterilir.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS
Yanıt, aralık değerlerini açıklayan bir ValueRange
nesnesinden oluşur. majorDimension
alanı, dizilerin sütunlara göre düzenlenmiş değer listeleri olduğunu gösterir.
{ "range": "Sheet1!A1:D3", "majorDimension": "COLUMNS", "values": [ ["Item", "Wheel", "Door"], ["Cost", "$20.50", "$15"], ["Stocked", "4", "2"], ["Ship Date", "3/1/2016", "3/15/2016"] ], }
Oluşturma seçenekleriyle tek bir aralığı okuma
Aşağıdaki spreadsheets.values.get
kod örneğinde, Sheet1!A1:D5 aralığındaki değerlerin nasıl okunacağı gösterilmiştir. Bu değerler, yanıtta döndürülür. Ancak, bu bilgilerin nasıl döndürüleceğini yönetmek için oluşturma seçeneklerini kullanır. FORMULA
öğesinin ValueRenderOption
ayarı, hesaplanan değer yerine formüllerin döndürüleceğini, SERIAL_NUMBER
öğesinin DateTimeRenderOption
ayarı ise tarihlerin sayı olarak döndürüleceğini belirtir.
Başka ayarlar da kullanılabilir. Sondaki boş satır ve sütunlar yoksayılır.
İstek protokolü burada gösterilir.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5? valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER
Yanıt, aralık değerlerini açıklayan bir ValueRange
nesnesinden oluşur. majorDimension
alanı, dizilerin satırlara göre düzenlenen değer listeleri olduğunu gösterir.
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "42430"], ["Door", "$15", "2", "42444"], ["Engine", "$100", "1", "42449"], ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"] ], }
Birden çok aralığı okuma
Aşağıdaki spreadsheets.values.batchGet
kod örneğinde Sheet1!B:B:B ve Sheet1!D:D aralıklarındaki değerlerin nasıl okunacağı gösterilmektedir. Bu değerler yanıtta döndürülür. UNFORMATTED_VALUE
öğesinin ValueRenderOption
ayarı, değerlerin hesaplandığını ancak yanıtta biçimlendirilmediğini gösterir. Sonraki boş satır ve sütunlar atlanır.
İstek protokolü burada gösterilir.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
Bu yöntem çağrısına verilen yanıt, e-tablo kimliğine sahip bir nesneden ve istenen her bir aralığa karşılık gelen ValueRange
nesne dizisinden oluşur. Bu nesne, isteklere göre sıralanmış olarak listelenir. majorDimension
alanı, dizilerin sütunlara göre düzenlenmiş değer listeleri olduğunu gösterir. Örneğin:
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!B1:B1000", "majorDimension": "COLUMNS", "values": [ ["Cost",20.5,15,100,135.5] ] }, { "range": "Sheet1!D1:D1000", "majorDimension": "COLUMNS", "values": [ ["Ship Date",42430,42444,42449,42449] ]s } ] }
Birden fazla sayfada birden çok aralığı okuma
Aşağıdaki spreadsheets.values.batchGet
kod örneğinde; Sheet1!A1:D5, Products!D1:D100 ve Sales!E4:F6 sayfalarındaki aralıklardaki değerlerin nasıl okunacağı gösterilmektedir. Bu değerler, yanıtta döndürülmektedir. UNFORMATTED_VALUE
öğesinin ValueRenderOption
ayarı, değerlerin hesaplandığını ancak yanıtta biçimlendirilmediğini gösterir. Sonraki boş satır ve sütunlar atlanır.
İstek protokolü burada gösterilir.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!A1:D5&ranges=Products!D1:D100&ranges=Sales!E4:F6&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
Bu yöntem çağrısına verilen yanıt, e-tablo kimliğine sahip bir nesneden ve istenen her bir aralığa karşılık gelen ValueRange
nesne dizisinden oluşur. Bu nesne, isteklere göre sıralanmış olarak listelenir. majorDimension
alanı, dizilerin sütunlara göre düzenlenmiş değer listeleri olduğunu gösterir. Örneğin:
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!A1:D5", "majorDimension": "COLUMNS", "values": [ [...], [...] ] }, { "range": "Products!D1:D100", "majorDimension": "COLUMNS", "values": [ [...] ] }, { "range": "Sales!E4:F6", "majorDimension": "COLUMNS", "values": [ [...], [...] ] } ] }