Method: spreadsheets.values.batchGetByDataFilter

Trả về một hoặc nhiều dải giá trị khớp với các bộ lọc dữ liệu được chỉ định. Để biết thêm thông tin, hãy xem bài viết Đọc, ghi và tìm kiếm siêu dữ liệu.

Người gọi phải chỉ định mã nhận dạng bảng tính và một hoặc nhiều DataFilters. Các 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ả về.

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

Thông số
spreadsheetId

string

Mã của bảng tính cần 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 sau:

Biểu diễn dưới dạng JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "majorDimension": enum (Dimension),
  "valueRenderOption": enum (ValueRenderOption),
  "dateTimeRenderOption": enum (DateTimeRenderOption)
}
Trường
dataFilters[]

object (DataFilter)

Bộ lọc dữ liệu dùng để so khớp các dải giá trị cần truy xuất. Những dải ô khớp với bất kỳ bộ lọc dữ liệu nào được chỉ định đều được đưa vào phản hồi.
majorDimension

enum (Dimension)

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

Ví dụ: nếu dữ liệu trong bảng tính là A1=1,B1=2,A2=3,B2=4, thì một yêu cầu chọn phạm vi đó 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 biểu thị các giá trị trong đầu ra. Lựa chọn kết xuất mặc định là FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

Cách biểu thị ngày, giờ và khoảng thời gian trong đầu ra. Tham số này sẽ bị bỏ qua nếu valueRenderOption là FORMATTED_VALUE. Lựa chọn hiển thị 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)
    }
  ]
}
Trường
spreadsheetId

string

Mã nhận dạng của bảng tính mà dữ liệu được truy xuất.
valueRanges[]

object (MatchedValueRange)

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

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.

MatchedValueRange

Một dải giá trị được một hoặc nhiều bộ lọc dữ liệu so khớp.

Biểu diễn dưới dạng JSON 
{
  "valueRange": {
    object (ValueRange)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
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ị.