Google Sheets API memungkinkan Anda membaca nilai dari sel, rentang, kumpulan rentang, dan seluruh sheet. Contoh di halaman ini mengilustrasikan beberapa operasi
baca umum dengan
resource
spreadsheets.values
. Anda juga dapat membaca nilai sel menggunakan
metode spreadsheets.get
, tetapi
biasanya
spreadsheets.values.get
atau
spreadsheets.values.batchGet
lebih mudah.
Contoh ini disajikan dalam bentuk permintaan HTTP agar tidak menggunakan bahasa. Untuk mempelajari cara mengimplementasikan pembacaan dalam berbagai bahasa menggunakan library klien Google API, lihat Membaca & menulis nilai sel.
Dalam contoh ini, SPREADSHEET_ID placeholder menunjukkan tempat Anda akan memberikan ID spreadsheet, yang dapat ditemukan dari URL spreadsheet. Rentang yang akan dibaca ditentukan menggunakan notasi A1 dalam URL permintaan. Contoh rentangnya adalah Sheet1!A1:D5.
Data sumber
Untuk contoh ini, anggaplah spreadsheet yang sedang dibaca memiliki data sumber berikut dalam sheet pertamanya ("Sheet1"). {i>String<i} di baris pertama adalah label untuk setiap kolom. Untuk melihat contoh cara membaca dari sheet lain di spreadsheet Anda, lihat notasi A1.
A | B | C | H | |
1 | Item | Biaya | Dengan Persediaan | Tanggal Pengiriman |
2 | Wheel | $20,50 | 4 | 1/3/2016 |
3 | Pintu | $15 | 2 | 15/3/2016 |
4 | Engine | $100 | 1 | 20/3/2016 |
5 | Total | $135,5 | 7 | 20/3/2016 |
Membaca satu rentang
Contoh kode
spreadsheets.values.get
berikut menunjukkan cara membaca nilai dari rentang Sheet1!A1:D5 dan menampilkannya
dalam respons. Baris dan kolom kosong di akhir akan dihilangkan.
Protokol permintaan ditampilkan di sini.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5
Respons terdiri dari objek
ValueRange
yang menjelaskan nilai rentang. Kolom
majorDimension
menunjukkan bahwa array adalah daftar nilai yang diatur menurut baris.
{ "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"] ], }
Membaca satu rentang yang dikelompokkan menurut kolom
Contoh kode
spreadsheets.values.get
berikut menunjukkan cara membaca nilai dari rentang Sheet1!A1:D3 dan menampilkannya
dalam respons, tetapi dikelompokkan berdasarkan kolom. Baris dan kolom akhir yang kosong
dihilangkan.
Protokol permintaan ditampilkan di sini.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS
Respons terdiri dari objek
ValueRange
yang menjelaskan nilai rentang. Kolom
majorDimension
menunjukkan bahwa array adalah daftar nilai yang diatur menurut kolom.
{ "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"] ], }
Membaca satu rentang dengan opsi rendering
Contoh kode
spreadsheets.values.get
berikut menunjukkan cara membaca nilai dari rentang Sheet1!A1:D5 dan menampilkannya
dalam respons, tetapi menggunakan opsi rendering untuk mengelola cara informasi
tersebut ditampilkan. Setelan
ValueRenderOption
dari
FORMULA
menunjukkan bahwa formula yang akan ditampilkan, bukan
nilai yang dihitung, dan setelan
DateTimeRenderOption
dari SERIAL_NUMBER
menunjukkan bahwa tanggal akan ditampilkan sebagai angka.
Setelan lainnya juga dimungkinkan. Baris dan kolom akhir yang kosong
dihilangkan.
Protokol permintaan ditampilkan di sini.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5? valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER
Respons terdiri dari objek
ValueRange
yang menjelaskan nilai rentang. Kolom
majorDimension
menunjukkan bahwa array adalah daftar nilai yang diatur menurut baris.
{ "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)"] ], }
Membaca beberapa rentang
Contoh kode
spreadsheets.values.batchGet
berikut menunjukkan cara membaca nilai dari rentang Sheet1!B:B dan Sheet1!D:D dan
menampilkannya dalam respons. Setelan
ValueRenderOption
dari UNFORMATTED_VALUE
menunjukkan bahwa nilai dihitung, tetapi tidak diformat
dalam respons. Baris dan kolom kosong di akhir akan dihilangkan.
Protokol permintaan ditampilkan di sini.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
Respons terhadap panggilan metode ini terdiri dari objek dengan ID spreadsheet
dan array objek
ValueRange
yang sesuai dengan setiap rentang yang diminta, yang tercantum sesuai urutan
permintaannya. Kolom
majorDimension
menunjukkan bahwa array adalah daftar nilai yang diatur menurut kolom. Contoh:
{ "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 } ] }
Membaca beberapa rentang di beberapa sheet
Contoh kode
spreadsheets.values.batchGet
berikut menunjukkan cara membaca nilai dari rentang di sheet1!A1:D5,
Products!D1:D100, dan Sales!E4:F6 dan menampilkannya dalam respons. Setelan
ValueRenderOption
dari UNFORMATTED_VALUE
menunjukkan bahwa nilai dihitung, tetapi tidak diformat
dalam respons. Baris dan kolom kosong di akhir akan dihilangkan.
Protokol permintaan ditampilkan di sini.
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
Respons terhadap panggilan metode ini terdiri dari objek dengan ID spreadsheet
dan array objek
ValueRange
yang sesuai dengan setiap rentang yang diminta, yang tercantum sesuai urutan
permintaannya. Kolom
majorDimension
menunjukkan bahwa array adalah daftar nilai yang diatur menurut kolom. Contoh:
{ "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": [ [...], [...] ] } ] }