Temel okuma

Google E-Tablolar API'sı hücrelerden, aralıklardan, aralık kümelerinden, ve tüm e-tablolarda raporlayın. Bu sayfadaki örneklerde, yaygın görülen okumaların Yeşil Ofis’teki spreadsheets.values gösterir. Hücre değerlerini ayrıca spreadsheets.get yöntemi, ancak genellikle spreadsheets.values.get veya spreadsheets.values.batchGet daha kolaydır.

Bu örnekler, HTTP istekleri şeklinde sunulur. nötr. Google API istemci kitaplıkları, Okuma ve hücreye yaz değerleri için de kullanılabilecektir.

Bu örneklerde SPREADSHEET_ID yer tutucusu, e-tablo kimliğini sağlamalıdır. Bu URL, e-tablonun URL'sinden bulunabilir. Okunacak aralık: istekte A1 gösterimi kullanılarak belirtilir URL'yi tıklayın. Sayfa1!A1:D5 gibi bir aralık örnek verilebilir.

Kaynak veriler

Bu örnekler için okunmakta olan e-tablonun aşağıdaki kaynağa sahip olduğunu varsayalım verilerini ("Sayfa1") kapsar. İlk satırdaki dizeler şuna ait etiketlerdir: tek tek sütunlar. Diğer e-tablolardan nasıl okuyacağınızla ilgili örnekleri görüntülemek için A1 gösterimine bakın.

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

Tek bir aralığı okuma

Aşağıdakiler spreadsheets.values.get kod örneği, Sheet1!A1:D5 aralığındaki değerlerin nasıl okunacağını gösterir. yanıt verebilirsiniz. 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, ValueRange aralığı değerlerini açıklayan nesne olarak kabul edilir. İlgili içeriği oluşturmak için kullanılan 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ğıdakiler spreadsheets.values.get kod örneği, Sheet1!A1:D3 aralığındaki değerlerin nasıl okunacağını gösterir ve bunlar yanıtta gösterilir, ancak sütuna göre gruplandırılır. Sondaki boş satır ve sütunlar: atlandı.

İstek protokolü burada gösterilir.

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS

Yanıt, ValueRange aralık değerlerini açıklayan nesne olarak kabul edilir. İlgili içeriği oluşturmak için kullanılan 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ğıdakiler spreadsheets.values.get kod örneği, Sheet1!A1:D5 aralığındaki değerlerin nasıl okunacağını gösterir. bunları yanıtta belirtir, ancak bu bilginin nasıl görüneceğini yönetmek için hatası döndürülür. İlgili içeriği oluşturmak için kullanılan ValueRenderOption ayarı FORMULA kodu, ve DateTimeRenderOption SERIAL_NUMBER öğesinin ayarı, tarihlerin sayı olarak döndürüleceğini belirtir. Başka ayarlar da kullanılabilir. Sondaki boş satır ve sütunlar: atlandı.

İ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, ValueRange aralık değerlerini açıklayan nesne olarak kabul edilir. İlgili içeriği oluşturmak için kullanılan 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ğıdakiler spreadsheets.values.batchGet kod örneği, Sheet1!B:B: Sheet1!D:D ve Sheet1!B:B: bunları yanıtta döndürür. İlgili içeriği oluşturmak için kullanılan ValueRenderOption ayarı UNFORMATTED_VALUE değeri, değerlerin hesaplandığını ancak biçimlendirilmediğini gösterir kullanıcı olabilir. 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 oluşur. ve bir dizi ValueRange belirlenen sırada listelenmiş, talep edilen her bir aralığa karşılık gelen nesneler istendi. İlgili içeriği oluşturmak için kullanılan 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ğıdakiler spreadsheets.values.batchGet kod örneği, Sheet1!A1:D5 sayfalarındaki aralıklarda değerlerin nasıl okunacağını gösterir. Ürünler!D1:D100 ve Satış!E4:F6 ve bunları yanıtta döndürür. İlgili içeriği oluşturmak için kullanılan ValueRenderOption ayarı UNFORMATTED_VALUE değeri, değerlerin hesaplandığını ancak biçimlendirilmediğini gösterir kullanıcı olabilir. 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 oluşur. ve bir dizi ValueRange belirlenen sırada listelenmiş, talep edilen her bir aralığa karşılık gelen nesneler istendi. İlgili içeriği oluşturmak için kullanılan 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": [
        [...],
        [...]
      ]
    }
  ]
}