Method: spreadsheets.values.get

Trả về một dải giá trị từ một bảng tính. Phương thức gọi phải chỉ định mã nhận dạng bảng tính và một dải ô.

Yêu cầu HTTP

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
spreadsheetId

string

Mã của bảng tính để truy xuất dữ liệu.
range

string

Ký hiệu A1 hoặc ký hiệu R1C1 của dải ô để truy xuất giá trị.

Tham số truy vấn

Thông số
majorDimension

enum (Dimension)

Phương diện chính mà kết quả sẽ sử dụng.

Ví dụ: nếu dữ liệu bảng tính trong Trang tính 1 là: A1=1,B1=2,A2=3,B2=4, thì yêu cầu range=Sheet1!A1:B2?majorDimension=ROWS sẽ trả về [[1,2],[3,4]], trong khi yêu cầu range=Sheet1!A1:B2?majorDimension=COLUMNS sẽ trả về [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

Cách trình bày các giá trị trong kết quả. Tuỳ chọn hiển thị mặc định là FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

Cách trình bày ngày, giờ và thời lượng trong kết quả. Trạng thái này sẽ bị bỏ qua nếu valueRenderOption là FORMATTED_VALUE. Tuỳ chọn hiển thị dateTime mặc định là SERIAL_NUMBER.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của ValueRange.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Để biết thêm thông tin, hãy xem bài viết Hướng dẫn uỷ quyền.