Method: spreadsheets.values.batchClear

Usuwa co najmniej jeden zakres wartości z arkusza kalkulacyjnego. Rozmówca musi podać identyfikator arkusza kalkulacyjnego i co najmniej jeden zakres. Wyczyszczone są tylko wartości – pozostałe właściwości komórki (takie jak formatowanie i weryfikacja danych) są zachowywane.

Żądanie HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego do zaktualizowania.

Treść żądania

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

Zapis JSON 
{
  "ranges": [
    string
  ]
}
Pola
ranges[]

string

Zakresy do usunięcia w notacji A1 lub notacji R1C1.

Treść odpowiedzi

Odpowiedź podczas usuwania zakresu wartości 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, do którego zostały zastosowane aktualizacje.
clearedRanges[]

string

Zakresy, które zostały wyczyszczone w notacji A1. Jeśli żądania dotyczą nielimitowanego zakresu lub zakresu przekraczającego arkusz, jest to zakres, który został wyczyszczony i ograniczony do limitu 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.