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