Google Sheets API memungkinkan Anda membaca nilai dari sel, rentang, kumpulan rentang, dan seluruh sheet. Contoh di halaman ini menggambarkan 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-contoh ini ditampilkan dalam bentuk permintaan HTTP dengan bahasa yang netral. Untuk mempelajari cara mengimplementasikan operasi baca dalam berbagai bahasa menggunakan library klien Google API, lihat Membaca & menulis nilai sel.
Dalam contoh ini, placeholder SPREADSHEET_ID menunjukkan tempat Anda akan memberikan ID spreadsheet, yang dapat ditemukan dari URL spreadsheet. Rentang yang akan dibaca akan ditentukan menggunakan notasi A1 dalam URL permintaan. Contohnya adalah Sheet1!A1:D5.
Data sumber
Untuk contoh ini, anggaplah spreadsheet yang sedang dibaca memiliki data sumber berikut di 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.
J | B | C | D | |
1 | Item | Biaya | Stok | 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 tersebut 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 berdasarkan 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 kosong di akhir
akan 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 tersebut 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 akan ditampilkan, bukan
nilai kalkulasi, dan setelan
DateTimeRenderOption
dari SERIAL_NUMBER
menunjukkan bahwa tanggal akan ditampilkan sebagai angka.
Setelan lainnya juga memungkinkan. 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? valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER
Respons terdiri dari
objek ValueRange
yang menjelaskan nilai rentang. Kolom
majorDimension
menunjukkan bahwa array tersebut 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 serta
menampilkan nilai tersebut 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
yang diminta. Kolom
majorDimension
menunjukkan bahwa array tersebut 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 sheet Sheet1!A1:D5,
Products!D1:D100, dan Sales!E4:F6, lalu 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
yang diminta. Kolom
majorDimension
menunjukkan bahwa array tersebut 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": [ [...], [...] ] } ] }