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

Dải ô mà các giá trị che phủ, trong ký hiệu A1. Đối với đầ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 ở cuối. Khi thêm giá trị, trường này đại diện cho dải ô để tìm kiếm một bảng, sau đó giá trị sẽ được thêm vào.

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]], còn 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 thì [[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ì giá trị mặc định sẽ là ROWS.

values[]

array (ListValue format)

Dữ liệu đã được đọc hoặc cần 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à từng 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 đầu ra, 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. Giá trị rỗng sẽ bị bỏ qua. Để đặt một ô thành một giá trị trống, hãy đặt giá trị chuỗi thành một 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 giá trị trong 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 được 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á giá trị khỏi một bảng tính.

get

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

update

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