Usuwa co najmniej jeden zakres wartości z arkusza kalkulacyjnego. Element wywołujący musi określić identyfikator arkusza kalkulacyjnego i co najmniej 1 element DataFilters
. Zakresy pasujące do dowolnego z określonych filtrów danych zostaną wyczyszczone. Wyczyszczone są tylko wartości – wszystkie pozostałe właściwości komórki (np. formatowanie, sprawdzanie poprawności danych itp.) zostają zachowane.
Żądanie HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
spreadsheetId |
Identyfikator arkusza kalkulacyjnego do zaktualizowania. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"dataFilters": [
{
object ( |
Pola | |
---|---|
dataFilters[] |
Parametr |
Treść odpowiedzi
Odpowiedź wyświetlana podczas czyszczenia zakresu wartości wybranych w arkuszu kalkulacyjnym przy użyciu funkcji DataFilters
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
Pola | |
---|---|
spreadsheetId |
Arkusz kalkulacyjny, do którego zastosowano zmiany. |
clearedRanges[] |
Zakresy, które zostały wyczyszczone, w notacji A1. Jeśli żądania dotyczą nieograniczonego zakresu lub zakresu większego niż granice arkusza, są to rzeczywiste zakresy, które zostały wyczyszczone i ograniczone do limitów arkusza. |
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.