- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- MatchedValueRange
- Hãy làm thử!
Trả về một hoặc nhiều dải ô giá trị phù hợp với bộ lọc dữ liệu được 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
. Các phạm vi 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
Tham số | |
---|---|
spreadsheetId |
Mã nhận dạng 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 có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "dataFilters": [ { object ( |
Trường | |
---|---|
dataFilters[] |
Bộ lọc dữ liệu dùng để so khớp các phạm vi giá trị cần truy xuất. Các phạm vi khớp với bất kỳ bộ lọc dữ liệu đã chỉ định nào cũng được đưa vào phản hồi. |
majorDimension |
Phương diện chính mà kết quả sẽ sử dụng. Ví dụ: nếu dữ liệu trong bảng tính là: |
valueRenderOption |
Cách thể hiện các giá trị trong dữ liệu đầu ra. Tuỳ chọn kết xuất mặc định là |
dateTimeRenderOption |
Cách trình bày ngày, giờ và thời lượng trong kết quả. Tham số này sẽ bị bỏ qua nếu |
Nội dung phản hồi
Phản hồi khi truy xuất nhiều hơn một dải giá trị trong 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 ( |
Trường | |
---|---|
spreadsheetId |
Mã của bảng tính mà dữ liệu được truy xuất từ đó. |
valueRanges[] |
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
Dải giá trị được so khớp bởi một hoặc nhiều trình lọc dữ liệu.
Biểu diễn dưới dạng JSON |
---|
{ "valueRange": { object ( |
Trường | |
---|---|
valueRange |
Các giá trị khớp với |
dataFilters[] |
|