Temel okuma

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": [
        [...],
        [...]
      ]
    }
  ]
}