Trả về bảng tính ở mã nhận dạng đã cho. Phương thức gọi phải chỉ định mã nhận dạng bảng tính.
Phương thức này khác với bảng tính.get ở chỗ cho phép chọn những tập hợp con của dữ liệu bảng tính sẽ trả về bằng cách chỉ định tham số dataFilters
. Bạn có thể chỉ định nhiều DataFilters
. Việc chỉ định một hoặc nhiều bộ lọc dữ liệu sẽ trả lại các phần của bảng tính giao cắt các dải ô được khớp với bất kỳ bộ lọc nào.
Theo mặc định, dữ liệu trong lưới không được trả về. Bạn có thể bao gồm dữ liệu lưới theo một trong 2 cách:
Chỉ định mặt nạ trường liệt kê các trường mà bạn muốn bằng cách sử dụng tham số URL
fields
trong HTTPĐặt tham số
includeGridData
thành đúng (true). Nếu bạn đặt mặt nạ trường, tham sốincludeGridData
sẽ bị bỏ qua
Đối với bảng tính lớn, phương pháp hay nhất là chỉ truy xuất các trường bảng tính cụ thể mà bạn muốn.
Yêu cầu HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getByDataFilter
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
spreadsheetId |
Bảng tính để yêu cầu. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu với cấu trúc như sau:
Biểu diễn dưới dạng JSON |
---|
{
"dataFilters": [
{
object ( |
Các trường | |
---|---|
dataFilters[] |
|
includeGridData |
Đúng nếu trả về dữ liệu lưới. Tham số này sẽ bị bỏ qua nếu bạn đã đặt một mặt nạ trường trong yêu cầu. |
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 Spreadsheet
.
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.file
https://www.googleapis.com/auth/spreadsheets
Để biết thêm thông tin, hãy xem Hướng dẫn ủy quyền.