REST Resource: spreadsheets.values
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: ValueRange
Data dalam rentang spreadsheet.
Representasi JSON |
{
"range": string,
"majorDimension": enum (Dimension ),
"values": [
array
]
} |
Kolom |
range |
string
Rentang yang dicakup nilai, dalam notasi A1. Untuk output, rentang ini menunjukkan seluruh rentang yang diminta, meskipun nilai akan mengecualikan baris dan kolom di akhir. Saat menambahkan nilai, kolom ini mewakili rentang untuk menelusuri tabel, setelah itu nilai akan ditambahkan.
|
majorDimension |
enum (Dimension )
Dimensi utama nilai. Untuk output, jika data spreadsheet adalah: A1=1,B1=2,A2=3,B2=4 , meminta range=A1:B2,majorDimension=ROWS akan menampilkan [[1,2],[3,4]] , sedangkan meminta range=A1:B2,majorDimension=COLUMNS akan menampilkan [[1,3],[2,4]] . Untuk input, dengan range=A1:B2,majorDimension=ROWS , [[1,2],[3,4]] akan menetapkan A1=1,B1=2,A2=3,B2=4 . Dengan range=A1:B2,majorDimension=COLUMNS , [[1,2],[3,4]] akan menetapkan A1=1,B1=3,A2=2,B2=4 . Saat menulis, jika kolom ini tidak ditetapkan, defaultnya adalah ROWS.
|
values[] |
array (ListValue format)
Data yang dibaca atau akan ditulis. Ini adalah array array, array luar yang mewakili semua data dan setiap array dalam yang mewakili dimensi utama. Setiap item dalam array dalam sesuai dengan satu sel. Untuk output, baris dan kolom akhir yang kosong tidak akan disertakan. Untuk input, jenis nilai yang didukung adalah: bool, string, dan double. Nilai null akan dilewati. Untuk menetapkan sel ke nilai kosong, tetapkan nilai string ke string kosong.
|
Metode |
|
Menambahkan nilai ke spreadsheet. |
|
Menghapus satu atau beberapa rentang nilai dari spreadsheet. |
|
Menghapus satu atau beberapa rentang nilai dari spreadsheet. |
|
Menampilkan satu atau beberapa rentang nilai dari spreadsheet. |
|
Menampilkan satu atau beberapa rentang nilai yang cocok dengan filter data yang ditentukan. |
|
Menetapkan nilai dalam satu atau beberapa rentang spreadsheet. |
|
Menetapkan nilai dalam satu atau beberapa rentang spreadsheet. |
|
Menghapus nilai dari spreadsheet. |
|
Menampilkan rentang nilai dari spreadsheet. |
|
Menetapkan nilai dalam rentang spreadsheet. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-03-22 UTC.
[null,null,["Terakhir diperbarui pada 2025-03-22 UTC."],[],[],null,["# REST Resource: spreadsheets.values\n\n- [Resource: ValueRange](#ValueRange)\n - [JSON representation](#ValueRange.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ValueRange\n--------------------\n\nData within a range of the spreadsheet.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"range\": string, \"majorDimension\": enum (/workspace/sheets/api/reference/rest/v4/Dimension), \"values\": [ array ] } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `range` | `string` The range the values cover, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). For output, this range indicates the entire requested range, even though the values will exclude trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended. |\n| `majorDimension` | `enum (`[Dimension](/workspace/sheets/api/reference/rest/v4/Dimension)`)` The major dimension of the values. For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` will return `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return `[[1,3],[2,4]]`. For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]` will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS` then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`. When writing, if this field is not set, it defaults to ROWS. |\n| `values[]` | `array (`[ListValue](https://protobuf.dev/reference/protobuf/google.protobuf/#list-value)` format)` The data that was read or to be written. This is an array of arrays, the outer array representing all the data and each inner array representing a major dimension. Each item in the inner array corresponds with one cell. For output, empty trailing rows and columns will not be included. For input, supported value types are: bool, string, and double. Null values will be skipped. To set a cell to an empty value, set the string value to an empty string. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|\n| ### [append](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append) | Appends values to a spreadsheet. |\n| ### [batchClear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClear) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchClearByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClearByDataFilter) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchGet](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet) | Returns one or more ranges of values from a spreadsheet. |\n| ### [batchGetByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGetByDataFilter) | Returns one or more ranges of values that match the specified data filters. |\n| ### [batchUpdate](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate) | Sets values in one or more ranges of a spreadsheet. |\n| ### [batchUpdateByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdateByDataFilter) | Sets values in one or more ranges of a spreadsheet. |\n| ### [clear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/clear) | Clears values from a spreadsheet. |\n| ### [get](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) | Returns a range of values from a spreadsheet. |\n| ### [update](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update) | Sets values in a range of a spreadsheet. |"]]