Pembacaan dasar

Google Sheets API memungkinkan Anda membaca nilai dari sel, rentang, dan seluruh sheet. Contoh pada halaman ini menggambarkan beberapa bacaan yang umum operasi dengan spreadsheets.values resource Anda Anda juga dapat membaca nilai sel menggunakan Metode spreadsheets.get, tetapi biasanya spreadsheets.values.get atau spreadsheets.values.batchGet menjadi lebih mudah.

Contoh ini disajikan dalam bentuk permintaan HTTP untuk memilih bahasa netral. Untuk mempelajari cara mengimplementasikan pembacaan dalam berbagai bahasa menggunakan Library klien API, lihat Baca & tulis sel lainnya.

Dalam contoh ini, SPREADSHEET_ID placeholder menunjukkan lokasi Anda akan memberikan ID spreadsheet, yang dapat ditemukan dari URL {i>spreadsheet<i}. Rentang sel yang akan dibaca adalah yang ditentukan menggunakan notasi A1 dalam permintaan . Contoh rentangnya adalah Sheet1!A1:D5.

Data sumber

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

A B C D
1 Item Biaya Dengan Persediaan 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

Hal berikut spreadsheets.values.get contoh kode menunjukkan cara membaca nilai dari rentang Sheet1!A1:D5 dan mengembalikan mereka 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 ValueRange yang mendeskripsikan nilai rentang. Tujuan 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 menurut kolom

Hal berikut spreadsheets.values.get contoh kode menunjukkan cara membaca nilai dari rentang Sheet1!A1:D3 dan kembali data tersebut dalam respons, tetapi dikelompokkan berdasarkan kolom. Baris dan kolom kosong di belakangnya adalah dihilangkan.

Protokol permintaan ditampilkan di sini.

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS

Respons terdiri dari ValueRange yang mendeskripsikan nilai rentang. Tujuan 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

Hal berikut spreadsheets.values.get contoh kode menunjukkan cara membaca nilai dari rentang Sheet1!A1:D5 dan mengembalikan file tersebut dalam respons, tetapi menggunakan opsi rendering untuk mengelola bagaimana informasi itu akan dikembalikan. Tujuan Setelan ValueRenderOption dari FORMULA menunjukkan bahwa formula yang akan ditampilkan, bukan nilai yang dihitung, dan DateTimeRenderOption setelan SERIAL_NUMBER menunjukkan bahwa tanggal akan dikembalikan sebagai angka. Setelan lainnya juga dimungkinkan. Baris dan kolom kosong di belakangnya adalah 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 ValueRange yang mendeskripsikan nilai rentang. Tujuan Kolom majorDimension menunjukkan bahwa array tersebut 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

Hal berikut spreadsheets.values.batchGet contoh kode menunjukkan cara membaca nilai dari rentang Sheet1!B:B dan Sheet1!D:D dan menampilkannya dalam respons. Tujuan Setelan ValueRenderOption dari UNFORMATTED_VALUE menunjukkan bahwa nilai dihitung, tetapi tidak diformat dalam responsnya. 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 ValueRange yang sesuai dengan setiap rentang yang diminta, dicantumkan sesuai urutan diminta. Tujuan 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]
      ]s
    }
  ]
}

Membaca beberapa rentang di beberapa sheet

Hal berikut spreadsheets.values.batchGet contoh kode menunjukkan cara membaca nilai dari rentang dalam lembar Sheet1!A1:D5, Produk! D1:D100, dan Sales! E4:F6 dan menampilkannya sebagai respons. Tujuan Setelan ValueRenderOption dari UNFORMATTED_VALUE menunjukkan bahwa nilai dihitung, tetapi tidak diformat dalam responsnya. 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 ValueRange yang sesuai dengan setiap rentang yang diminta, dicantumkan sesuai urutan diminta. Tujuan Kolom majorDimension menunjukkan bahwa array adalah daftar nilai yang diatur berdasarkan 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": [
        [...],
        [...]
      ]
    }
  ]
}