Method: spreadsheets.get

Menampilkan spreadsheet dengan ID yang diberikan. Pemanggil harus menentukan ID spreadsheet.

Secara default, data dalam petak tidak ditampilkan. Anda dapat menyertakan data petak dengan salah satu dari 2 cara:

  • Menentukan mask kolom yang mencantumkan kolom yang diinginkan menggunakan parameter URL fields di HTTP

  • Menetapkan parameter URL includeGridData ke benar (true). Jika mask kolom ditetapkan, parameter includeGridData akan diabaikan

Untuk spreadsheet besar, sebagai praktik terbaik, ambil hanya kolom spreadsheet tertentu yang Anda inginkan.

Untuk mengambil hanya subset data spreadsheet, gunakan parameter URL ranges. Rentang ditentukan menggunakan notasi A1. Anda dapat menentukan satu sel (misalnya, A1) atau beberapa sel (misalnya, A1:D5). Anda juga bisa mendapatkan sel dari sheet lain dalam spreadsheet yang sama (misalnya, Sheet2!A1:C4) atau mengambil beberapa rentang sekaligus (misalnya, ?ranges=A1:D5&ranges=Sheet2!A1:C4). Membatasi rentang hanya akan menampilkan bagian spreadsheet yang berpotongan dengan rentang yang diminta.

Permintaan HTTP

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
spreadsheetId

string

Spreadsheet yang akan diminta.

Parameter kueri

Parameter
ranges[]

string

Rentang yang akan diambil dari spreadsheet.

includeGridData

boolean

Benar (true) jika data petak harus ditampilkan. Parameter ini diabaikan jika mask kolom ditetapkan dalam permintaan.

excludeTablesInBandedRanges

boolean

Benar (true) jika tabel harus dikecualikan dalam rentang bergaris. Salah (false) jika tidak ditetapkan.

commentsViewMode

enum (CommentsViewMode)

Mode tampilan komentar yang akan diterapkan ke spreadsheet. Hal ini memungkinkan Anda melihat spreadsheet dengan komentar yang dihilangkan atau disertakan. Jika tidak ada yang ditentukan, COMMENTS_VIEW_MODE_OMITTED akan digunakan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat instance Spreadsheet.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.