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 ini ditampilkan dalam bentuk permintaan HTTP agar tidak menggunakan bahasa yang netral. Untuk mempelajari cara mengimplementasikan pembacaan dalam berbagai bahasa menggunakan library klien Google API, lihat Membaca & menulis nilai sel.

Dalam contoh ini, placeholder SPREADSHEET_ID menunjukkan tempat Anda akan menyediakan ID spreadsheet, yang dapat ditemukan dari URL spreadsheet. Rentang yang akan dibaca 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 dalam 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.

A 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 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 bawah ini.

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 berdasarkan 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 menurut kolom. Baris dan kolom kosong di akhir akan dihilangkan.

Protokol permintaan ditampilkan di bawah ini.

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 berdasarkan 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 yang akan ditampilkan, bukan nilai yang dihitung, dan setelan DateTimeRenderOption dari SERIAL_NUMBER menunjukkan bahwa tanggal akan ditampilkan sebagai angka. Setelan lainnya juga dapat dipilih. Baris dan kolom kosong di akhir akan dihilangkan.

Protokol permintaan ditampilkan di bawah ini.

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

Protokol permintaan ditampilkan di bawah ini.

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 permintaannya. Kolom majorDimension menunjukkan bahwa array adalah daftar nilai yang diatur berdasarkan 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]
      ]
    }
  ]
}