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 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, okunmakta olan e-tablonun ilk sayfasında aşağıdaki kaynak verilerin ("Sayfa1") bulunduğunu varsayalım. İ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.

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ü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. 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, 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 öğ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. 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ı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 sayfadaki birden fazla 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 bulunan değerlerin nasıl okunacağı gösterilmektedir. Bu değerler, yanıtta döndürülmektedir. 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": [
        [...],
        [...]
      ]
    }
  ]
}