Pembacaan dasar

Google Sheets API memungkinkan Anda membaca nilai dari sel, rentang, kumpulan rentang, dan seluruh sheet. Contoh di 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 ini ditampilkan dalam bentuk permintaan HTTP agar bersifat netral bahasa. Untuk mempelajari cara menerapkan 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 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, lihat notasi A1.

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 akhir yang kosong 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 mendeskripsikan 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 akhir yang kosong 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 mendeskripsikan 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 dapat digunakan. Baris dan kolom akhir yang kosong 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 mendeskripsikan 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 akhir yang kosong 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 untuk panggilan metode ini terdiri dari objek dengan ID spreadsheet dan array objek ValueRange yang sesuai dengan setiap rentang yang diminta, yang tercantum dalam urutan permintaannya. 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 akhir yang kosong 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 untuk panggilan metode ini terdiri dari objek dengan ID spreadsheet dan array objek ValueRange yang sesuai dengan setiap rentang yang diminta, yang tercantum dalam urutan permintaannya. 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": [
        [...],
        [...]
      ]
    }
  ]
}