- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi ủy quyền
- Hãy làm thử!
Trả về một hoặc nhiều 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 hoặc nhiều dải ô.
Yêu cầu HTTP
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
spreadsheetId |
Mã của bảng tính để truy xuất dữ liệu. |
Tham số truy vấn
Các tham số | |
---|---|
ranges[] |
Ký hiệu A1 hoặc R1C1 của dải ô để truy xuất giá trị. |
majorDimension |
Thứ nguyên chính mà kết quả sẽ sử dụng. Ví dụ: nếu dữ liệu bảng tính là: |
valueRenderOption |
Cách hiển thị các giá trị trong kết quả. Tùy chọn hiển thị mặc định là |
dateTimeRenderOption |
Cách hiển thị ngày, giờ và khoảng thời gian trong kết quả. Giá trị này sẽ bị bỏ qua nếu |
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
Phản hồi khi truy xuất nhiều dải giá trị trong một bảng tính.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Các trường | |
---|---|
spreadsheetId |
Mã của bảng tính dùng để lấy dữ liệu. |
valueRanges[] |
Giá trị được yêu cầu. Thứ tự của ValueRanges giống như thứ tự của các dải được yêu cầu. |
Phạm vi ủy quyền
Yêu cầu một trong các phạm vi OAuth sau:
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 Hướng dẫn ủy quyền.