- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- MatchedValueRange
- Wypróbuj
Zwraca co najmniej 1 zakres wartości, który pasuje do określonych filtrów danych. Wywołujący musi podać identyfikator arkusza kalkulacyjnego i co najmniej 1 DataFilters
. Zwrócone zostaną zakresy, które pasują 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 chcesz pobrać dane. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "dataFilters": [ { object ( |
Pola | |
---|---|
dataFilters[] |
Filtry danych użyte do dopasowania zakresów wartości do pobrania. Odpowiedź zawiera zakresy, które pasują do dowolnego z określonych filtrów danych. |
majorDimension |
Główny wymiar, którego powinny używać wyniki. Jeśli na przykład dane w arkuszu kalkulacyjnym to: |
valueRenderOption |
Sposób przedstawiania wartości w danych wyjściowych. Domyślna opcja renderowania to |
dateTimeRenderOption |
Jak powinny być przedstawione daty, godziny i czasy trwania w danych wyjściowych. Ta wartość jest ignorowana, jeśli |
Treść odpowiedzi
Odpowiedź podczas pobierania więcej niż 1 zakresu wartości w arkuszu kalkulacyjnym wybranym przez funkcję 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 pobrano dane. |
valueRanges[] |
Żądane wartości z listą pasujących do nich filtrów danych. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu 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 na temat autoryzacji.
MatchedValueRange
Zakres wartości, który został dopasowany przez co najmniej 1 plik danych.
Zapis JSON |
---|
{ "valueRange": { object ( |
Pola | |
---|---|
valueRange |
Wartości dopasowane przez |
dataFilters[] |
|