Menampilkan spreadsheet dengan ID yang diberikan. Pemanggil harus menentukan ID spreadsheet.
Metode ini berbeda dari spreadsheets.get karena memungkinkan pemilihan subset data spreadsheet yang akan ditampilkan dengan menentukan parameter dataFilters
. Beberapa DataFilters
dapat ditentukan. Menentukan satu atau beberapa filter data akan menampilkan bagian spreadsheet yang berpotongan dengan rentang yang cocok dengan filter apa pun.
Secara default, data dalam petak tidak ditampilkan. Anda dapat menyertakan data petak dengan salah satu dari 2 cara berikut:
Tentukan mask kolom yang mencantumkan kolom yang Anda inginkan menggunakan parameter URL
fields
di HTTPSetel parameter
includeGridData
ke benar (true). Jika mask kolom ditetapkan, parameterincludeGridData
akan diabaikan
Untuk spreadsheet besar, sebagai praktik terbaik, hanya ambil kolom spreadsheet tertentu yang Anda inginkan.
Permintaan HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getByDataFilter
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
spreadsheetId |
Spreadsheet yang akan diminta. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"dataFilters": [
{
object ( |
Kolom | |
---|---|
dataFilters[] |
|
includeGridData |
Benar jika data petak akan ditampilkan. Parameter ini diabaikan jika mask kolom ditetapkan dalam permintaan. |
Isi respons
Jika berhasil, isi respons akan berisi instance Spreadsheet
.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Untuk informasi selengkapnya, lihat Panduan otorisasi.