Pembacaan dasar

Google Sheets API memungkinkan Anda membaca nilai dari sel, rentang, kumpulan 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-contoh ini ditampilkan dalam bentuk permintaan HTTP dengan bahasa yang netral. Untuk mempelajari cara mengimplementasikan operasi baca 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 akan ditentukan menggunakan notasi A1 dalam URL permintaan. Contohnya adalah Sheet1!A1:D5.

Data sumber

Untuk contoh ini, anggaplah spreadsheet yang sedang dibaca memiliki data sumber berikut di sheet pertamanya ("Sheet1"). {i>String<i} di baris pertama adalah label untuk setiap kolom. Untuk melihat contoh cara membaca dari sheet lain di spreadsheet Anda, lihat notasi A1.

J B C D
1 Item Biaya Stok Tanggal Pengiriman
2 Wheel $20,50 4 1/3/2016
3 Pintu $15 2 15/3/2016
4 Engine $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 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 tersebut 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 berdasarkan kolom

Contoh kode spreadsheets.values.get berikut menunjukkan cara membaca nilai dari rentang Sheet1!A1:D3 dan menampilkannya dalam respons, tetapi dikelompokkan berdasarkan kolom. Baris dan kolom kosong di akhir 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 tersebut 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 dari FORMULA menunjukkan bahwa formula akan ditampilkan, bukan nilai kalkulasi, dan setelan DateTimeRenderOption dari SERIAL_NUMBER menunjukkan bahwa tanggal akan ditampilkan sebagai angka. Setelan lainnya juga memungkinkan. Baris dan kolom kosong di akhir 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 tersebut 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 serta menampilkan nilai tersebut dalam respons. Setelan ValueRenderOption dari UNFORMATTED_VALUE menunjukkan bahwa nilai dihitung, tetapi tidak diformat dalam respons. Baris dan kolom kosong di akhir 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 tersebut 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 dari UNFORMATTED_VALUE menunjukkan bahwa nilai dihitung, tetapi tidak diformat dalam respons. Baris dan kolom kosong di akhir 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 tersebut 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": [
        [...],
        [...]
      ]
    }
  ]
}