Method: spreadsheets.values.batchClearByDataFilter

Czyści z arkusza kalkulacyjnego co najmniej 1 zakres wartości. Wywołujący musi podać identyfikator arkusza kalkulacyjnego i co najmniej 1 element DataFilters. Zakresy pasujące do dowolnego z podanych filtrów danych zostaną wyczyszczone. Wyczyszczone zostaną tylko wartości, a wszystkie inne właściwości komórki (takie jak formatowanie, walidacja danych itp.) pozostaną bez zmian.

Żą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

string

Identyfikator arkusza kalkulacyjnego, który chcesz zaktualizować.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Pola
dataFilters[]

object (DataFilter)

DataFilters służy do określenia, które zakresy mają zostać wyczyszczone.

Treść odpowiedzi

Odpowiedź po wyczyszczeniu zakresu wartości wybranych za pomocą DataFilters w arkuszu kalkulacyjnym.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
Pola
spreadsheetId

string

Arkusz kalkulacyjny, w którym zastosowano aktualizacje.
clearedRanges[]

string

Zakresy, które zostały opróżnione, 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, 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 dotyczącym autoryzacji.