Pembacaan dasar

Google Sheets API memungkinkan Anda membaca nilai dari sel, rentang, set 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 ini disajikan dalam bentuk permintaan HTTP agar netral terhadap bahasa. Untuk mempelajari cara menerapkan pembacaan 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 ditentukan menggunakan notasi A1 di URL permintaan. Contoh rentang adalah Sheet1!A1:D5.

Data sumber

Untuk contoh ini, asumsikan spreadsheet yang dibaca memiliki data sumber berikut di sheet pertamanya ("Sheet1"). String di baris pertama adalah label untuk setiap kolom. Untuk melihat contoh cara membaca dari sheet lain di spreadsheet Anda, lihat Notasi A1.

	A	B	C	D
1	Item	Biaya	Tersedia	Tanggal Pengiriman
2	Wheel	$20,50	4	1/3/2016
3	Pintu	$15	2	15/3/2016
4	Mesin	$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 tidak disertakan.

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 adalah daftar nilai yang disusun 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 menurut kolom

Contoh kode spreadsheets.values.get berikut menunjukkan cara membaca nilai dari rentang Sheet1!A1:D3 dan menampilkannya dalam respons, tetapi dikelompokkan menurut kolom. Baris dan kolom kosong di akhir tidak disertakan.

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 adalah daftar nilai yang disusun 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 FORMULA menunjukkan bahwa formula akan ditampilkan, bukan nilai yang dihitung, dan setelan DateTimeRenderOption SERIAL_NUMBER menunjukkan bahwa tanggal akan ditampilkan sebagai angka. Setelan lainnya juga dapat digunakan. Baris dan kolom kosong di akhir tidak disertakan.

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 adalah daftar nilai yang disusun 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 menampilkannya dalam respons. Setelan ValueRenderOption UNFORMATTED_VALUE menunjukkan bahwa nilai dihitung, tetapi tidak diformat dalam respons. Baris dan kolom kosong di akhir tidak disertakan.

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 dicantumkan dalam urutan permintaannya. Kolom majorDimension menunjukkan bahwa array adalah daftar nilai yang disusun 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 serta menampilkannya dalam respons. Setelan ValueRenderOption UNFORMATTED_VALUE menunjukkan bahwa nilai dihitung, tetapi tidak diformat dalam respons. Baris dan kolom kosong di akhir tidak disertakan.

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 dicantumkan dalam urutan permintaannya. Kolom majorDimension menunjukkan bahwa array adalah daftar nilai yang disusun 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": [
        [...],
        [...]
      ]
    }
  ]
}