Method: spreadsheets.values.clear

Usuwa wartości z arkusza kalkulacyjnego. Element wywołujący musi podać identyfikator i zakres arkusza kalkulacyjnego. Czyszczone są tylko wartości – wszystkie pozostałe właściwości komórki (takie jak formatowanie, sprawdzanie poprawności danych itp.) są zachowywane.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego do zaktualizowania.

range

string

Notacja A1 lub notacja R1C1 wartości do usunięcia.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź podczas czyszczenia zakresu wartości w arkuszu kalkulacyjnym.

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

Zapis JSON
{
  "spreadsheetId": string,
  "clearedRange": string
}
Pola
spreadsheetId

string

Arkusz kalkulacyjny, do którego zastosowano zmiany.

clearedRange

string

Zakres (w notacji A1), który został wyczyszczony. Jeśli żądanie dotyczyło nieograniczonego zakresu lub zakresu zakresu przekraczającego granice arkusza, będzie to rzeczywisty zakres, który został wyczyszczony i mieści się w granicach arkusza.

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.