Temel okuma

Google E-Tablolar API'si hücrelerdeki, aralıklardaki, aralık kümelerindeki ve sayfaların tamamındaki değerleri okumanıza olanak tanır. Bu sayfadaki örneklerde spreadsheets.values kaynağıyla sık kullanılan bazı okuma işlemleri gösterilmektedir. Hücre değerlerini spreadsheets.get yöntemini kullanarak da okuyabilirsiniz ancak genellikle spreadsheets.values.get veya spreadsheets.values.batchGet yöntemi daha kolaydır.

Bu örnekler, dilsiz olması için HTTP istekleri biçiminde sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde okumaları 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 keşfedilebilen 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 örnek olarak verilebilir.

Kaynak veriler

Bu örnekler için, okunmakta olan e-tablonun ilk sayfasında ("Sheet1") aşağıdaki kaynak verilerin bulunduğunu varsayalım. İlk satırdaki dizeler, bağımsız sütunların etiketleridir. E-tablonuzdaki diğer sayfalardan nasıl okunacağına ilişkin örnekleri görüntülemek için A1 notasyonuna bakın.

	CEVAP	B	C	D
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 $	7	20.03.2016

Tek bir aralık okuma

Aşağıdaki spreadsheets.values.get kod örneğinde, Sheet1!A1:D5 aralığındaki değerlerin nasıl okunacağı ve yanıtta bu değerlerin nasıl döndürüleceği gösterilmektedir. Sondaki boş satırlar 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üzenlenmiş değer listeleri olduğunu belirtir.

{
  "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ık okuma

Aşağıdaki spreadsheets.values.get kod örneğinde, Sheet1!A1:D3 aralığındaki değerlerin nasıl okunacağı ve bu değerlerin sütuna göre gruplandırılarak yanıtta nasıl döndürüleceği gösterilmektedir. Sondaki boş satır ve sütunlar dikkate alınmaz.

İ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 belirtir.

{
  "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ğı ve bu değerlerin yanıtta nasıl döndürüleceği gösterilmektedir ancak bu bilgilerin nasıl döndürüleceğini yönetmek için oluşturma seçenekleri kullanılmaktadır. FORMULA ValueRenderOption ayarı, hesaplanan değer yerine formüllerin döndürüleceğini ve SERIAL_NUMBER değeri DateTimeRenderOption ayarı da tarihlerin sayı olarak döndürüleceğini belirtir. Başka ayarlar da mümkündür. Sondaki boş satır ve sütunlar dikkate alınmaz.

İ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üzenlenmiş değer listeleri olduğunu belirtir.

{
  "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 fazla aralığı okuma

Aşağıdaki spreadsheets.values.batchGet kod örneğinde, Sheet1!B:B ve Sheet1!D:D aralıklarındaki değerlerin nasıl okunacağı gösterilmektedir ve bunları yanıtta döndürmektedir. UNFORMATTED_VALUE ValueRenderOption ayarı, değerlerin hesaplandığını ancak yanıtta biçimlendirilmediğini gösterir. Sondaki boş satırlar 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 nesne ve istenen her bir aralığa karşılık gelen ve istendikleri sırada listelenmiş olan bir ValueRange nesne dizisinden oluşur. majorDimension alanı, dizilerin sütunlara göre düzenlenmiş değer listeleri olduğunu belirtir. Ö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 çok 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ıklarda yer alan değerlerin nasıl okunacağı gösterilmektedir ve yanıtta bu değerleri döndürür. UNFORMATTED_VALUE ValueRenderOption ayarı, değerlerin hesaplandığını ancak yanıtta biçimlendirilmediğini gösterir. Sondaki boş satırlar 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 nesne ve istenen her bir aralığa karşılık gelen ve istendikleri sırada listelenmiş olan bir ValueRange nesne dizisinden oluşur. majorDimension alanı, dizilerin sütunlara göre düzenlenmiş değer listeleri olduğunu belirtir. Ö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": [
        [...],
        [...]
      ]
    }
  ]
}