REST Resource: spreadsheets.values

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 phương thức nhập, 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 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

append

Thêm các giá trị vào một bảng tính.

batchClear

Xoá một hoặc nhiều dải ô giá trị khỏi bảng tính.

batchClearByDataFilter

Xoá một hoặc nhiều dải ô giá trị khỏi bảng tính.

batchGet

Trả về một hoặc nhiều dải ô chứa giá trị từ một bảng tính.

batchGetByDataFilter

Trả về một hoặc nhiều dải ô giá trị khớp với bộ lọc dữ liệu đã chỉ định.

batchUpdate

Đặt giá trị trong một hoặc nhiều dải ô của bảng tính.

batchUpdateByDataFilter

Đặt giá trị trong một hoặc nhiều dải ô của bảng tính.

clear

Xoá các giá trị khỏi bảng tính.

get

Trả về một dải ô chứa giá trị từ một bảng tính.

update

Đặt giá trị trong một dải ô của bảng tính.