Temel okuma

Google E-Tablolar API, hücrelerdeki, aralıklardaki, aralık kümelerindeki ve e-tabloların tamamındaki değerleri okumanıza olanak tanır. Bu sayfada, spreadsheets.values kaynağıyla yapılan bazı yaygın 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öntemini kullanmak daha kolaydır.

Bu örnekler, dil açısından tarafsız olması için HTTP istekleri biçiminde 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 başlıklı makaleyi inceleyin.

Bu örneklerde, SPREADSHEET_ID yer tutucusu, e-tablo URL'sinden bulunabilen e-tablo kimliğini nerede sağlayacağınızı gösterir. Okunacak aralıklar, istek URL'sinde A1 notasyonu kullanılarak belirtilir. Örnek aralık: Sayfa1!A1:D5.

Kaynak veriler

Bu örneklerde, okunan e-tablonun ilk sayfasında ("Sayfa1") aşağıdaki kaynak verilerin bulunduğu varsayılır. İlk satırdaki dizeler, sütunların etiketleridir. E-tablonuzdaki diğer sayfalardan nasıl veri okuyacağınıza dair örnekleri görmek için A1 gösterimi bölümüne bakın.

	A	B	C	D
1	Öğe	Maliyet	Stokta	Gönderim Tarihi
2	Tekerlek	20,50 ABD doları	4	3/1/2016
3	Kapı	Hong Kong doları	2	15.03.2016
4	Motor	100 ABD doları	1	20.03.2016
5	Toplam	135,5 ABD doları	7	20.03.2016

Tek bir aralığı okuma

Aşağıdaki spreadsheets.values.get kod örneğinde, Sayfa1!A1:D5 aralığındaki değerlerin nasıl okunacağı ve yanıtta nasıl döndürüleceği gösterilmektedir. 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üzenlenmiş 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, E-Tablo1!A1:D3 aralığındaki değerlerin nasıl okunacağı ve sütuna göre gruplandırılarak yanıtta nasıl döndürüleceği gösterilmektedir. 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: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, Sayfa1!A1:D5 aralığındaki değerlerin nasıl okunacağı ve 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 için ValueRenderOption ayarı, hesaplanmış değer yerine formüllerin döndürüleceğini, SERIAL_NUMBER için DateTimeRenderOption ayarı ise tarihlerin sayı olarak döndürüleceğini gösterir. Diğer ayarlar da mümkündür. 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?
            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 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, E-Tablo1!B:B ve E-Tablo1!D:D aralığından değerlerin nasıl okunacağı ve yanıtta nasıl döndürüleceği gösterilmektedir. UNFORMATTED_VALUE öğesinin ValueRenderOption ayarı, değerlerin hesaplanıp 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ının yanıtı, e-tablo kimliğini içeren bir nesneden ve istenen her aralık için istenen sırayla listelenen bir ValueRange nesnesi dizisinden oluşur. 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 e-tablodaki birden fazla aralığı okuma

Aşağıdaki spreadsheets.values.batchGet kod örneğinde, Sayfa1!A1:D5, Ürünler!D1:D100 ve Satışlar!E4:F6 e-tablolarındaki aralıklardaki değerlerin nasıl okunacağı ve yanıtta nasıl döndürüleceği gösterilmektedir. UNFORMATTED_VALUE öğesinin ValueRenderOption ayarı, değerlerin hesaplanıp 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ının yanıtı, e-tablo kimliğini içeren bir nesneden ve istenen her aralık için istenen sırayla listelenen bir ValueRange nesnesi dizisinden oluşur. 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": [
        [...],
        [...]
      ]
    }
  ]
}