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 |
Identyfikator arkusza kalkulacyjnego do zaktualizowania. |
range |
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 |
Arkusz kalkulacyjny, do którego zostały zastosowane aktualizacje. |
clearedRange |
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.