Method: spreadsheets.values.clear

Usuwa wartości z arkusza kalkulacyjnego. Element wywołujący musi określić identyfikator i zakres arkusza kalkulacyjnego. Tylko wartości zostaną wyczyszczone – zostaną zachowane wszystkie pozostałe właściwości komórki (takie jak formatowanie, weryfikacja danych itd.).

Żą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 zapis R1C1 wartości do usunięcia;

Treść żądania

Treść żądania musi być pusta.

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,
  "clearedRange": string
}
Pola
spreadsheetId

string

Arkusz kalkulacyjny, do którego zostały zastosowane aktualizacje.

clearedRange

string

Zakres (w notacji A1) usunięty. (Jeśli żądanie dotyczyło niegranicznego zakresu lub zakresu przekraczającego granice arkusza, będzie 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.