Pembacaan dasar

Google Sheets API memungkinkan Anda membaca nilai dari sel, rentang, kumpulan rentang, dan seluruh sheet. Contoh pada halaman ini mengilustrasikan 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-contoh ini disajikan dalam bentuk permintaan HTTP dengan bahasa yang netral. 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, anggaplah spreadsheet yang dibaca memiliki data sumber berikut dalam sheet pertamanya ("Sheet1"). String di baris pertama adalah label untuk masing-masing 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	3/1/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 setelahnya akan dihilangkan.

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 diatur 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 setelahnya akan dihilangkan.

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 diatur 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 dimungkinkan. Baris dan kolom kosong setelahnya akan dihilangkan.

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 diatur 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 dan menampilkannya dalam respons. Setelan ValueRenderOption UNFORMATTED_VALUE menunjukkan bahwa nilai dihitung, tetapi tidak diformat dalam respons. Baris dan kolom kosong setelahnya akan dihilangkan.

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 tercantum sesuai urutan yang diminta. Kolom majorDimension menunjukkan bahwa array adalah daftar nilai yang diatur 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, lalu menampilkannya dalam respons. Setelan ValueRenderOption UNFORMATTED_VALUE menunjukkan bahwa nilai dihitung, tetapi tidak diformat dalam respons. Baris dan kolom kosong setelahnya akan dihilangkan.

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 tercantum sesuai urutan yang diminta. Kolom majorDimension menunjukkan bahwa array adalah daftar nilai yang diatur 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": [
        [...],
        [...]
      ]
    }
  ]
}