Method: spreadsheets.values.batchGet

Menampilkan satu atau beberapa rentang nilai dari spreadsheet. Pemanggil harus menentukan ID spreadsheet dan satu atau beberapa rentang.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
spreadsheetId

string

ID spreadsheet tempat data diambil.

Parameter kueri

Parameter
ranges[]

string

Notasi A1 atau notasi R1C1 rentang untuk mengambil nilai.

majorDimension

enum (Dimension)

Dimensi utama yang harus digunakan hasil.

Misalnya, jika data spreadsheet adalah: A1=1,B1=2,A2=3,B2=4, meminta ranges=["A1:B2"],majorDimension=ROWS akan menampilkan [[1,2],[3,4]], sedangkan meminta ranges=["A1:B2"],majorDimension=COLUMNS akan menampilkan [[1,3],[2,4]].

valueRenderOption

enum (ValueRenderOption)

Cara nilai akan ditampilkan dalam output. Opsi render default adalah ValueRenderOption.FORMATTED_VALUE.

dateTimeRenderOption

enum (DateTimeRenderOption)

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

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons saat mengambil lebih dari satu rentang nilai dalam spreadsheet.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
Kolom
spreadsheetId

string

ID spreadsheet tempat data diambil.

valueRanges[]

object (ValueRange)

Nilai yang diminta. Urutan ValueRanges sama dengan urutan rentang yang diminta.

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.