Temel okuma

Google Sheets API, hücrelerden, aralıklardan, aralık kümelerinden ve tüm sayfalardan değer okumanıza olanak tanır. Bu sayfadaki örnekler, spreadsheets.values kaynağıyla ilgili bazı yaygın okuma işlemlerini gösterir. Hücre değerlerini spreadsheets.get yöntemini kullanarak da okuyabilirsiniz ancak genellikle spreadsheets.values.get veya spreadsheets.values.batchGet daha kolaydır.

Bu örnekler, dilden bağımsız olması için 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 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 bir aralık: Sayfa1!A1:D5.

Kaynak veriler

Bu örneklerde, okunan e-tablonun ilk sayfasında ("Sayfa1") aşağıdaki kaynak verilerin bulunduğunu varsayın. İlk satırdaki dizeler, sütunların etiketleridir. E-tablonuzdaki diğer sayfalardan nasıl okuma yapılacağına dair örnekleri görmek için A1 gösterimi başlıklı makaleyi inceleyin.

Tek bir aralığı okuma

Aşağıdaki spreadsheets.values.get kod örneğinde, Sheet1!A1:D5 aralığındaki değerlerin nasıl okunacağı ve yanıtta 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 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ğı ve yanıtta nasıl döndürüleceği gösterilmektedir. Değerler yanıtta sütuna göre gruplandırılmış olarak döndürülür. 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: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ğı 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ılır. FORMULA'ün ValueRenderOption ayarı, hesaplanan değer yerine formüllerin döndürülmesi gerektiğini, SERIAL_NUMBER'ün DateTimeRenderOption ayarı ise tarihlerinin sayı olarak döndürülmesi gerektiğini gösterir. Diğer ayarlar da mümkündür. 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?
            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 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ğı ve yanıtta nasıl döndürüleceği gösterilmektedir. UNFORMATTED_VALUE ayarının ValueRenderOption, 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ğini içeren bir nesne ve istenen her aralığa karşılık gelen ValueRange nesnelerinin bir dizisinden oluşur. Bu nesneler, istendikleri sırayla 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 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ıklardan değerlerin nasıl okunacağı ve yanıtta nasıl döndürüleceği gösterilmektedir. UNFORMATTED_VALUE ayarının ValueRenderOption, 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ğini içeren bir nesne ve istenen her aralığa karşılık gelen ValueRange nesnelerinin bir dizisinden oluşur. Bu nesneler, istendikleri sırayla 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": [
        [...],
        [...]
      ]
    }
  ]
}