Method: spreadsheets.values.clear

Usuwa wartości z arkusza kalkulacyjnego. Element wywołujący musi określić identyfikator arkusza kalkulacyjnego i zakres. 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/{range}:clear

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego do zaktualizowania.

range

string

Zapis A1 lub zapis R1C1 wartości do wyczyszczenia.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź wyświetlana 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

Wyczyszczony zakres (w notacji A1). Jeśli żądanie dotyczyło nieograniczonego zakresu lub zakresu większego niż granice arkusza, jest to rzeczywisty zakres, który został wyczyszczony i ograniczony 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.