Method: spreadsheets.getByDataFilter

Trả về bảng tính tại mã nhận dạng đã cho. Phương thức gọi phải chỉ định mã bảng tính.

Phương thức này khác với spreadsheets.get ở chỗ cho phép chọn tập hợp con dữ liệu bảng tính cần 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ả về các phần của bảng tính giao nhau với các dải ô khớp với bất kỳ bộ lọc nào.

Theo mặc định, dữ liệu trong lưới sẽ không được trả về. Bạn có thể thê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 bạn muốn bằng cách sử dụng tham số URL fields trong HTTP

  • Đặt tham số includeGridData thành 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, tốt nhất bạn chỉ nên 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

Thông số
spreadsheetId

string

Bảng tính cần yêu cầu.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "includeGridData": boolean,
  "excludeTablesInBandedRanges": boolean
}
Trường
dataFilters[]

object (DataFilter)

DataFilters dùng để chọn dải ô cần truy xuất từ bảng tính.
includeGridData

boolean

True nếu cần trả về dữ liệu lưới. Thông số này sẽ bị bỏ qua nếu bạn đã đặt mặt nạ trường trong yêu cầu.
excludeTablesInBandedRanges

boolean

Đúng nếu bạn muốn loại trừ các bảng trong dải ô. Sai nếu không được đặt.

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 uỷ 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 uỷ quyền.