Method: spreadsheets.values.get

Menampilkan rentang nilai dari spreadsheet. Pemanggil harus menentukan ID spreadsheet dan rentang.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
spreadsheetId

string

ID {i>spreadsheet<i} yang datanya akan diambil.

range

string

Notasi A1 atau notasi R1C1 rentang yang nilainya akan diambil.

Parameter kueri

Parameter
majorDimension

enum (Dimension)

Dimensi utama yang harus digunakan hasil.

Misalnya, jika data spreadsheet di Sheet1 adalah: A1=1,B1=2,A2=3,B2=4, permintaan range=Sheet1!A1:B2?majorDimension=ROWS akan menampilkan [[1,2],[3,4]], sedangkan meminta range=Sheet1!A1:B2?majorDimension=COLUMNS akan menampilkan [[1,3],[2,4]].

valueRenderOption

enum (ValueRenderOption)

Cara nilai harus dinyatakan dalam output. Opsi render default adalah FORMATTED_VALUE.

dateTimeRenderOption

enum (DateTimeRenderOption)

Bagaimana tanggal, waktu, dan durasi harus ditampilkan dalam output. Pesan ini diabaikan jika valueRenderOption adalah FORMATTED_VALUE. Opsi render dateTime default adalah SERIAL_NUMBER.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance ValueRange.

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 informasi selengkapnya, lihat Panduan otorisasi.