- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Dopasowanie_wartości zakresu
- Wypróbuj
Zwraca co najmniej 1 zakres wartości pasujących do określonych filtrów danych. Element wywołujący musi zawierać identyfikator arkusza kalkulacyjnego i co najmniej jeden element DataFilters
. Zakresy, które pasują do dowolnego z filtrów danych w żądaniu, zostaną zwrócone.
Żą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 chcesz pobrać dane. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "dataFilters": [ { object ( |
Pola | |
---|---|
dataFilters[] |
Filtry danych służące do dopasowywania zakresów wartości do pobrania. Zakresy, które pasują do dowolnego z określonych filtrów danych, są uwzględniane w odpowiedzi. |
majorDimension |
Główny wymiar, który powinien być używany w wynikach. Jeśli na przykład dane arkusza kalkulacyjnego to: |
valueRenderOption |
Sposób prezentowania wartości w danych wyjściowych. Domyślna opcja renderowania to |
dateTimeRenderOption |
Sposób prezentowania dat, godzin i czasów trwania w danych wyjściowych Ta wartość jest ignorowana, jeśli |
Treść odpowiedzi
Odpowiedź przy pobieraniu więcej niż jednego 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.
DopasowanyzakresWartość
Zakres wartości, który został dopasowany przez co najmniej 1 plik danych.
Zapis JSON |
---|
{ "valueRange": { object ( |
Pola | |
---|---|
valueRange |
Wartości dopasowane przez zasadę |
dataFilters[] |
|