- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- MatchedValueRange
- Wypróbuj
Zwraca co najmniej 1 zakres wartości, które pasują do określonych filtrów danych. Element wywołujący musi określić identyfikator arkusza kalkulacyjnego i co najmniej 1 element DataFilters
. Zwrócone zostaną zakresy pasujące do dowolnego z filtrów danych w żądaniu.
Żądanie HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
spreadsheetId |
Identyfikator arkusza kalkulacyjnego, z którego mają zostać pobrane dane. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "dataFilters": [ { object ( |
Pola | |
---|---|
dataFilters[] |
Filtry danych używane do dopasowywania zakresów wartości do pobrania. Odpowiedź zawiera zakresy pasujące do dowolnego z określonych filtrów danych. |
majorDimension |
Główny wymiar, którego należy użyć w przypadku wyników. Jeśli np. dane w arkuszu kalkulacyjnym to |
valueRenderOption |
Sposób przedstawiania wartości w danych wyjściowych. Domyślną opcją renderowania jest |
dateTimeRenderOption |
Sposób przedstawiania dat, godzin i czasu trwania w danych wyjściowych. Ta wartość jest ignorowana, jeśli |
Treść odpowiedzi
Odpowiedź wyświetlana przy pobieraniu więcej niż 1 zakresu wartości w arkuszu kalkulacyjnym wybranym przez użytkownika DataFilters
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Pola | |
---|---|
spreadsheetId |
Identyfikator arkusza kalkulacyjnego, z którego zostały pobrane dane. |
valueRanges[] |
Żądane wartości z listą pasujących filtrów danych. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Więcej informacji znajdziesz w przewodniku po autoryzacji.
MatchedValueRange
Zakres wartości, do którego został dopasowany co najmniej 1 plik danych.
Zapis JSON |
---|
{ "valueRange": { object ( |
Pola | |
---|---|
valueRange |
Wartości pasujące do reguły |
dataFilters[] |
Wartość |