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
  ]
}
Các trường
range

string

Dải ô mà các giá trị bao 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ù giá trị sẽ loại trừ các hàng và cột đứng sau. Khi thêm giá trị, trường này thể hiện phạm vi để tìm kiếm bảng, sau đó giá trị sẽ được nối 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]], trong khi yêu cầu range=A1:B2,majorDimension=COLUMNS sẽ trả về [[1,3],[2,4]].

Để 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 viết, nếu bạn không đặt trường này, trường này sẽ mặc định là ROWS.

values[]

array (ListValue format)

Dữ liệu đã đọc hoặc cần ghi. Đây là một mảng 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 đầu ra, các hàng và cột cuối trống sẽ không được đưa vào.

Đối với đầ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 pháp

append

Nối các giá trị vào một bảng tính.

batchClear

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

batchClearByDataFilter

Xóa 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ị 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

Xóa các giá trị khỏi bảng tính.

get

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

update

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