Method: spreadsheets.values.batchGetByDataFilter

Trả về một hoặc nhiều dải giá trị phù hợp với bộ lọc dữ liệu đã chỉ đị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 DataFilters. Dải ô khớp với bất kỳ bộ lọc dữ liệu nào trong yêu cầu sẽ được trả lại.

Yêu cầu HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter

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

Tham số đường dẫn

Các tham số
spreadsheetId

string

Mã của bảng tính để truy xuất dữ liệ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 (DataFilter)
    }
  ],
  "majorDimension": enum (Dimension),
  "valueRenderOption": enum (ValueRenderOption),
  "dateTimeRenderOption": enum (DateTimeRenderOption)
}
Các trường
dataFilters[]

object (DataFilter)

Bộ lọc dữ liệu được sử dụng để khớp với phạm vi giá trị cần truy xuất. Các dải ô khớp với bất kỳ bộ lọc dữ liệu đã chỉ định nào sẽ được đưa vào phản hồi.
majorDimension

enum (Dimension)

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à: A1=1,B1=2,A2=3,B2=4, thì một yêu cầu chọn dải ô đó và đặt majorDimension=ROWS sẽ trả về [[1,2],[3,4]], trong khi một yêu cầu đặt majorDimension=COLUMNS sẽ trả về [[1,3],[2,4]].
valueRenderOption

enum (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à FORMATTED_VALUE.
dateTimeRenderOption

enum (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 valueRenderOption là FORMATTED_VALUE. Tuỳ chọn kết xuất dateTime mặc định là SERIAL_NUMBER.

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 do DataFilters chọn.

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 (MatchedValueRange)
    }
  ]
}
Các trường
spreadsheetId

string

Mã của bảng tính dùng để lấy dữ liệu.
valueRanges[]

object (MatchedValueRange)

Các giá trị được yêu cầu với danh sách bộ lọc dữ liệu khớp với các giá trị đó.

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.

Phạm vi giá trị phù hợp

Phạm vi giá trị khớp với một hoặc nhiều trình phân tích dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "valueRange": {
    object (ValueRange)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Các trường
valueRange

object (ValueRange)

Các giá trị được DataFilter so khớp.
dataFilters[]

object (DataFilter)

DataFilters từ yêu cầu khớp với dải giá trị.