REST Resource: spreadsheets.values
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: ValueRange
Dữ liệu trong một dải ô của bảng tính.
Biểu diễn dưới dạng JSON |
{
"range": string,
"majorDimension": enum (Dimension ),
"values": [
array
]
} |
Trường |
range |
string
Phạm vi chứa các giá trị, theo ký hiệu A1. Đối với dữ liệu đầu ra, dải ô này cho biết toàn bộ dải ô được yêu cầu, mặc dù các giá trị sẽ loại trừ các hàng và cột theo sau. Khi nối các giá trị, trường này đại diện cho phạm vi để tìm kiếm một bảng, sau đó các giá trị sẽ được nối.
|
majorDimension |
enum (Dimension )
Phương diện chính của các giá trị. Đối với đầu ra, nếu dữ liệu bảng tính là: A1=1,B1=2,A2=3,B2=4 , thì việc yêu cầu range=A1:B2,majorDimension=ROWS sẽ trả về [[1,2],[3,4]] , trong khi yêu cầu range=A1:B2,majorDimension=COLUMNS sẽ trả về [[1,3],[2,4]] . Đối với dữ liệu đầu vào, với range=A1:B2,majorDimension=ROWS , [[1,2],[3,4]] sẽ đặt A1=1,B1=2,A2=3,B2=4 . Với range=A1:B2,majorDimension=COLUMNS , [[1,2],[3,4]] sẽ đặt A1=1,B1=3,A2=2,B2=4 . Khi ghi, nếu bạn không đặt trường này, thì trường này sẽ mặc định là ROWS.
|
values[] |
array (ListValue format)
Dữ liệu đã đọc hoặc sẽ được ghi. Đây là một mảng gồm các mảng, mảng bên ngoài đại diện cho tất cả dữ liệu và mỗi mảng bên trong đại diện cho một phương diện chính. Mỗi mục trong mảng bên trong tương ứng với một ô. Đối với kết quả, các hàng và cột trống ở cuối sẽ không được đưa vào. Đối với dữ liệu đầu vào, các loại giá trị được hỗ trợ là: bool, string và double. Các giá trị rỗng sẽ bị bỏ qua. Để đặt một ô thành giá trị trống, hãy đặt giá trị chuỗi thành chuỗi trống.
|
Phương thức |
|
Thêm các giá trị vào bảng tính. |
|
Xoá một hoặc nhiều dải ô giá trị khỏi bảng tính. |
|
Xoá một hoặc nhiều dải ô giá trị khỏi bảng tính. |
|
Trả về một hoặc nhiều dải ô chứa giá trị từ một bảng tính. |
|
Trả về một hoặc nhiều dải ô giá trị khớp với bộ lọc dữ liệu đã chỉ định. |
|
Đặt giá trị trong một hoặc nhiều dải ô của bảng tính. |
|
Đặt giá trị trong một hoặc nhiều dải ô của bảng tính. |
|
Xoá các giá trị khỏi bảng tính. |
|
Trả về một dải ô chứa giá trị từ một bảng tính. |
|
Đặt giá trị trong một dải ô của bảng tính. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-03-22 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]